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EXTENSIBLE INFORMATION SYSTEM 

A portion of the disclosure of this patent document contains material, which is 
subject to copyright protection. The copyright owner has no objection to the facsimile 
reproduction by anyone of the patent document or the patent disclosure, as it appears 
in the Patent and Trademark Office patent file or records, but otherwise reserves all 
copyright rights whatsoever. 

This application claims priority of co-pending U.S. Provisional Patent 
Application Serial No. 60/242,041 entitled "Extensible Information System (XIS)" by 
R. Kadel et al„ filed October 20, 2000. Priority of the filing date of October 20, 2000 
is hereby claimed, and the disclosure of said Provisional Patent Application is hereby 
incorporated by reference. 

BACKGROUND 

1. Field Of The Invention 

The present invention relates generally to data processing systems and, more 
particularly, to systems that process, analyze, and display data or information. 

2. Description of the Related Art 

The continuing inroads made by computer technology into the practices of 
information storage and manipulation have opened up new realms of possibility for 
intelligent, informed decision-making. From labor statistics and scientific databases 
like the human genome project to traffic patterns and aircraft positions, the 
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availability of information in electronic form allows sophisticated analysis techniques 
and display methods to be applied at the touch of a button. However this diverse 
array of information also poses significant challenges in areas such as: 

effective organization of infoimation; 
5 - ability to interpret and manipulate information in an increasingly 

wide variety of formats so that data and processing software can 

be brought together in a compatible but also timely and effective 

way; and 

recognizing and navigating relationships between disparate 

10 information types. 

This task of information management has already grown beyond the ability of 
human operators to keep pace with it, and in most applications, there is far more 
relevant information electronically available on the web and elsewhere than is 
effectively used. The problem is that software affording display of and interaction 

1 5 with information must be custom-designed for the particular type and format of the 
information it will work with. This leads to high costs of software development and 
limited availability of software appropriate to information of interest, and poor 
integration between information from different sources. An analyst mtist use one 
program when dealing with geographic distribution data such as precipitation amounts 

20 or land use, another for rendering 3-dimensional terrain, another for examining 

congressional districts and voting records, and so on. Many desirable applications of 
available data, such as determining correlations between political party and land use 
strategy in this case, fall between the cracks left by specialized applications, and there 
is no easy way to allow them to interoperate. 

25 The primary means for allowing one application to operate on the results of 

another are the limited cut and paste facilities offered by many operating systems, 
which allow plain or formatted text or images to be moved between programs. There 
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is no independent way to transfer structured data such as a table of numbers with 
particular column headings, a set of lists of items under specified categories, or even • 
something as simple as a single number with an associated unit of measurement 
From the discussion above, it should be apparent that there is a need for 
5 computer systems that have greater ability to develop, integrate, and interoperate with 
disparate sources of information, to more easily develop software applications, 
components, or objects, and to facilitate interoperation of data between software 
components. The present invention fulfills this need. 

10 SUMMARY OF THE INVENTION 

In accordance with the present invention, a framework for use with object 
oriented programming (OOP) systems provides a framework user with classes that 
comprise a mediation layer that defines an interface between data source components 

15 and data consumer components such that the configuration of the data source 

components can be specified independently of the data consumer components. The 
mediation layer specifies data relationships of the data objects, domain methods for 
defining groups of class attributes, attribute metadata for defining groups of class 
attributes, and change event registration for detecting changes in data values. Thus, 

20 when extended, the mediation layer of the framework can support runtime data 
manipulation between unrelated data source components and data consumer 
components. In this way, the framework provides an extensible information system. 
The framework will be referred to herein as "XIS", and is especially suited to assist in 
the development of information-handling systems or applications. 

25 Data source components that are configured for a non-XIS-aware 

programming environment or framework may still be used with XIS by "wrapping" 
such source components with code to conform to the interface requirements. Data 
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objects of the well-known "Java" programming language are examples of data source 
components. Data consumer components thus are able to use or consume various data 
source components regardless of the data types and the data source. Thus, once a data 
consumer component is developed within the XIS framework, any data source 
components within the XIS framework may also accordingly be used. The 
framework can be provided as a group of APIs (application programming interface). 

The XIS framework of the present invention also includes libraries and APIs 
that provide information management technologies that enable developers and 
integrators to combine XlS-aware components, data sources, and off-the-shelf 
JavaBeans into complete systems designed around whatever architecture is best for 
the situation. XIS further supports multiple, dynamic domains and is scalable to n-tier 
systems using the latest technology. The framework enables many developers to 
choose architectures based on their requirements (e.g., server, client/server, 
application server, web server, standalone, hand-held, etc.). 

Other features and advantages of the present invention should be apparent from 
the following description, which illustrates, by way of example, the principles of the 
invention. 

BRIEF DESCRIPTIONS OF THE FIGURES 

Figure 1 is a diagram of the extensible information system (XIS) framework 
constructed in accordance with the present invention. 

Figure 2 is a more detailed diagram of Figure 1, showing the various interfaces 
within XIS, constructed in accordance with the present invention. 

Figure 3 A is a mqre detailed diagram of Figure 1, including information and 
services available within XIS, constructed in accordance with the present invention. 
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Figure 3B is a hierarchical structure diagram of an embodiment of an 
InfoModel constructed in accordance with the present invention. 

Figure 4 is a more detailed diagram of Figure 1 showing various information 
available to components within XIS constructed in accordance with the present 
5 invention. 

Figure 5 is a diagram of the semantic representation of a data item within the 
XIS framework constructed in accordance with the present invention. 

Figures 6A to 6F show data consumer components, particularly display 
components, constructed in accordance with the present invention. 
10 Figure 7 shows a consumer component displaying the properties exposed by a 

data source object constructed in accordance with the present invention. 

Figure 8 is a unified modeling language (UML) diagram of a Person object. 

Figure 9 lists a set of attributes exposed within the XIS framework by the 
Person object of Figure 6 constructed in accordance with the present invention. 
15 Figure 10 illustrates that an object constructed in accordance with the present 

invention may subscribe to more than one domain policy or definition. 

Figure 1 1 shows a domain usage and sequence scenario between a consumer 
component and source component constructed in accordance with the present 
invention. 

20 Figures 12A to 12D list information regarding a Type Metadata package class 

typically implemented in the mediation layer and constructed in accordance with the 
present invention. 

Figure 13 shows a relationship usage scenario diagram between a consumer 
component and source component constructed in accordance with the present 
25 invention. 

Figure 14 is a flow chart that shows a reference resolution scenario usage 
sequence in which an indirect reference to an information element is created, passed 
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around, and then resolved by two separate data consumers, causing reconstruction to 
occur only the first time. 

Figure 15 lists an exemplary Java source file to implement an information- 
handling application constructed in accordance with the present invention. 

Figures 16A to 16B list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
invention. 

Figure 17 shows a data consumer component using a source component 
constructed in accordance with the present invention. 

Figures 18A to 18B list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
invention. 

Figures 19 A to 19B list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
invention. 

- Figure 20 shows a data consumer component using a source component 
constructed in accordance with the present invention. 

Figure 21 lists an exemplary Java source file to implement an information- 
handling application constructed in accordance with the present invention. 

Figures 22A to 22C list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
invention. 

Figures 23A to 23D list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
invention. 

Figures 24A and 24B show two data consumer components using a source 
component constructed in accordance with the present invention. 
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Figures 25A to 25C list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
• invention. 

Figure 26 shows a data consumer component using a source component 
5 constructed in accordance with the present invention. 

Figure 27A and Figure 27B show a flow chart of a data exposure facility 
within the XIS framework constructed in accordance with the present invention. 

Figure 28 is a diagram of how InfoModels constructed in accordance with the 
present invention provide contextualization with the XIS framework. 
io Figure 29 is a diagram of the pluggable service facilities within XIS 

constructed in accordance with the present invention. 

Figure 30 shows a flow diagram of a wizard or an API constructed in 
accordance with the present invention that assists in creating XML (extensible 
markup language) DSIs and database DSIs. 
15 Figure 31 shows objects and methods involved in distribution collaboration 

facilities constructed in accordance with the present invention. 

Figure 32 shows semantic repositories for distributed agents constructed in 
accordance with the present invention. 

Figures 33 A to 33P list information regarding a ContentlnfoBean class 
20 constructed in accordance with the present invention. 

Figures 34A to 34D list an information management package typically 
implemented in the mediation layer and constructed in accordance with the present 
invention. 

Figures 35A to 35F list an InfoMbdel interface package typically implemented 
25 in the mediation layer and constructed in accordance with the present invention. 
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Figures 36A to 36B list a package for handling change events typically 
implemented in the mediation layer and constructed in accordance with the present 
invention. 

Figures 36C and 36D show two sequence diagrams showing how change 
5 • events are handled and constructed in accordance with the present invention. 

Figures 37A to 37D list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
invention. 

Figures 38A, 38B, 38C, and 38D show two data consumer components using a 
10 source component constructed in accordance with the present invention. 

Figures 39A, 39B, and 39C is list information concerning an AttributeAlias 
class of the framework. 

Figure 40 is a block diagram of a computer device that may be used to operate 
with the framework, in accordance with the present invention. 

15 

DETAILED DESCRIPTION 



The following detailed description illustrates the invention by way of example, 
not by way of limitation of the principles of the invention. This description will 

20 clearly enable one skilled in the art to make and use the invention, and describes 
several embodiments, adaptations, variations, alternatives and uses of the invention, 
including what we presently believe is the best mode of carrying out the invention. 

The invention will be described by way of illustration with reference to various 
classes, objects, sample codes, etc. written within the exemplary framework, but it 

25 should be understood that such classes, class libraries, application programming 

interfaces, interfaces, objects, etc. may be differently coded, implemented, designed, 
etc. and yet support the functions and features of the present invention. 
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Object-Oriented Technology 

Many application programs and APIs (application program interface) are 
developed using object-oriented (00) technology. Using 00 technology, a system is 
typically developed as a collection of interrelated cooperative objects that are 

5 instances of classes that typically include corresponding states and behaviors; A class 
is a blueprint or template that defines the variables and the methods common to all 
objects that are instances of the class. An object maintains its state in one or more 
variables and implements its behavior with methods or functions. 

Object-oriented programming (OOP) techniques encapsulate, or bind together, 

10 data and the methods that operate on them. This encapsulation permits program 
development to more closely model real-world entities and breaks up program 
development efforts into smaller, more manageable pieces. Although OOP 
techniques have done much to improve program development efficiency, such 
techniques still require a great degree of code generation on the part of developers, 

15 which discourages program reuse. 

Even with OOP techniques, specifying data sources and the way in which data 
will be retrieved or updated from the data sources are still typically hard-coded within 
the objects themselves. An object, for example, may be specified to display pricing 
data (for example, a price display object) and would likely be hard-coded such that 

20 the data source is predefined. Thus, an object may be written to retrieve data from a 
source such as a relational database management system (RDBMS), a spreadsheet file 
such as a spreadsheet in the format of "EXCEL" spreadsheet application by Microsoft 
Corporation, or the object may be written to an XML file. Nevertheless, in 
conventional systems, the price display object would be limited such that if a different 

25 source of data, for example, an XML file rather than an EXCEL file, has to be used, 
the object has to be modified to incorporate access to and manipulation of the XML 
file. Furthermore, if a different set of fields are retrieved, for example, latitude and 
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longitude (i.e., data fields unrelated to pricing information), a new object to display 
latitude and longitude may have to be written to display such information in tabular 
format. 

Table I below shows the data configuration of a typical object 



Table I 

State/Properties: Name, SSN, position, DOB, and . . . 
Behavior: RecordQ 

getRecords(DateRange) 

promote Q 



For an application to be able to use this data object, the application would need 
10 prior knowledge of object properties (state) and behavior. The application would be 
tightly coupled with the class from which the object was instantiated. The meaning 
and intent of the data might be found in the source code or by asking the original 
programmers (e.g., SSN is social security number stored as string rather than a 
numeric type). 

15 Assuming the object was created by one application written independently of 

another, the object could not be intelligently exchanged between the first application 
and the other with the expectation that the object would be processed unless the 
applications were tightly coupled. A way to have objects be used in various 
applications is thus highly desirable to reduce programming time and resources. 

20 Common OOP languages include "Java" from Sun Microsystems, Inc. of Palo 

Alto, California, USA, C++, Simula, and Smalltalk. 
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Framework 

The concept of a framework is an important part of 00 programming 
technique. A framework is a specification of the classes and the relationships 
between classes such that the framework defines a class hierarchy that can be used 
over and over again, with overrides and extensions. In this way, an initial problem 
solution specified by a class hierarchy can be adapted and customized for new 
circumstances, simplifying program maintenance. In essence, a framework is a set of 
OOP classes that embodies a predetermined set of attributes and methods for 
providing a common group of behaviors. 

OOP frameworks have been developed in an effort to further reduce program 
development costs. An application program developer utilizes the framework and 
builds upon it, starting with the classes, attributes, and methods defined by the 
framework designer and adding subclasses and attributes and modifying methods 
depending on the problem to be solved. Such changes to the framework are typically 
referred to as framework extensions, and are made possible by the OOP notions of 
inheritance and polymorphism. Thus, a framework can speed the development of an 
00 application program. The challenge confronting framework developers, then, is 
to define a set of classes and methods that best supports the desired problem solution 
and will accept the most likely framework extensions. Thus, the designer of a 
framework must carefully assess what framework users will most likely need in the 
way of classes, attributes, and methods. 

It is therefore a technical advantage of the present invention to provide a 
framework that allows information-handling software to adapt to new data types and 
formats of information, so that a single application built within this framework has a 
significantly broader range of compatibilities and domains of usefulness than a 
conventional application and, further, may automatically interoperate at a structured 
level with other similarly enhanced applications. In one embodiment of the present 
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invention, desirable applications of data such as determining correlations between 
political party and land use strategy may be facilitated. 

In an embodiment of the present invention, a single information visualization 
or manipulation application is able to handle many diverse types of information, even 
5 those that are conceived and developed subsequently to the completion of 
development of the application itself 

In another embodiment of the present invention, information from multiple and - 
diverse sources yet sharing some basic feature in common - such as being distributed 
in geographic space, or being distances measured in meters - can be simultaneously 
10 displayed (superimposed) and manipulated within a single application. This invention 
further provides means of access to common data sources such as relational databases, 
extensible markup language (XML) streams, and "Java 11 programming language 
software objects. 

In an embodiment of the present invention, an information-handling 
1 5 application is defined as any software application which is capable of utilizing 

digitally available structured information in bulk form, such as from electronic files, 
databases, or internet web sites to provide a display and/or a set of possible 
manipulations to a user, such as after some internal processing and transformation of 
the information such as summarizing it, performing computations on it, or selecting a 
20 subset Examples include but are not limited to graphing programs, analysis tools (for 
handling financial data, statistical, time series, etc.), and interfaces to geographic 
information systems. Prototypical information-handling applications process 
structured information that has some form of hierarchical and/or modular structure. 
In one embodiment, image and word processing applications are not examples of 
25 what we term information-handling applications. In another embodiment of the 
present invention, structured information in bulk form does not include plain text or 
specific electronic media files such as MP3 files. 
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A conventional information handling application such as a graphing program 
comprises two major components: one component handles the intake of information, 
from storage devices, the network, or user input, and the other component handles the 
display of the information. There may also be parts of the application that perform 

5 computations or transformations on the information before it is displayed. From the 
developer's perspective, a modular piece of software that handles a portion of (or all 
of) the data intake function is a data source component, because it provides 
information to other components within the application. A modular piece of software 
that handles part of (or all of) either the computation, transformation, or display of 

10 information is a data consumer component, because it uses (consumes) information 
provided by the data sources. 

Data sources and data consumers communicate with each other by making 
function calls. The particular functions and their parameters are defined as part of an 
internal version of an application program interface (API). The data consumer 

15 components handle data that is given them through specific calls on their respective 
API, so that information provided through data source components written for 
different applications will not be accepted. This situation provides little opportunity 
for reuse of data source or consumer components, since each is written to interoperate 
only with a specific instantiation of the other. 

20 In an embodiment of the present invention, an internal mediation layer is 

inserted between the data source components and the consumer components that 
expose data structure in a standardized way. Consumer components are constructed 
to use this common API, which is suitable for expressing an extremely wide variety of 
information types. Data source components can be constructed to deliver the 

25 information they take in this format, or a small amount of code can be written to 

translate the output of another source component into the common format The result 
of the construction is that any consumer component can work with any data source 
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component regardless of the specific nature of the information involved, or whether 
one was anticipated during the design of the other. The common API allows 
consumer components to automatically extract whatever features of information from 
a particular source they are most suitable for displaying or computing with, and also 

5 allows them to utilize all the other features of that information in a generic, 
unspecialized fashion. 

Other embodiments of the present invention comprise: (1) a system for 
representing information such that: (a) a single fixed interface suffices to describe a 
wide range of information types, (b) the information is rendered self describing to an 

10 extent, and (c) relationships between different information elements are expressed; (2) 
an apparatus for allowing this information representation to be employed as a medium 
between data source and data consumer software components; (3) a method and 
apparatus for attaching clarifying material on "intended* use" to information so that 
consumer components can handle it more appropriately; (4) a method and apparatus 

15 for providing a context to all information consumption affording control over security 
and visibility of data; (5) a method and apparatus for allowing users to transfer 
information from one consumer component to another through intuitive "drag and 
drop" and "cut and paste" interfaces; (6) a method and apparatus for developing 
enhanced information handling applications based on the foregoing framework; (7) a 

20 method and apparatus for automatically re-representing data from partially self 
describing sources including relational databases, XML streams, and Java software 
objects; (8) a method and apparatus allowing end users using computers distributed 
over a network to collaboratively view and manipulate information; and (9) a method 
and apparatus allowing software components distributed over a network to 

25 automatically obtain annotations on intent and other aspects of encountered data. 

Most aspects of this invention can be implemented in any object oriented 
programming language such as Smalltalk, Objective C, C++, or Java. Certain aspects 
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of it, pointed out below, are especially suited to object oriented languages such as 
Java and Objective C that provide for run time self analysis by programs. However, 
these are in every case peripheral aspects, and the essential parts of the invention may 
be implemented in an object oriented language like C++ without these capabilities. 

5 We will from time to time make reference to a "preferred embodiment" implemented 
in Java, but this should not be taken to be limiting. 

In a preferred embodiment the present invention provides a system and/or 
framework of software components for purposes of aiding development of 
information-handling applications. The system and/or framework of object-oriented 

10 software components aid the development of applications that read, gather, or receive 
electronic information and allow the display of such information to and manipulation 
by users. These applications are structured in a way so that there are distinct data 
. source components and data consumer components. The crucial features of the 
system and/or framework are the fact that data is seen by consumers only through a 

15 standard, conventionalized interface that incorporates: a breakdown into attributes, 
relationships, semantically-annotated "domain methods", event-broadcasting of 
changes in the foregoing to all registered consumers, metadata for each attribute 
providing certain declarative and procedural information including unit of measure, 
content length, data quality, default value, comparator function, summary function, 

20 validation function, and input/output functions for display and user editing within an 
extensible set of interface modalities, related data items available for each data item 
including those in child or generic relationships, and including the ability to store a 
reference without direct access to the related item itself (it can be reconstructed if 
needed), and contextualization such that the attributes, relationships, events, and 

25 methods available for a data item depends on context (see below). 

In a related embodiment, the system and/or framework includes methods for 
data exposure wherein the system determines automatically which method is 
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employed in any particular case, and the choice is invisible to consumers. Exemplary 
methods such as, a data source component which directly provides the standard 
interface, a data source component which is accompanied by a separate Translator 
component which maps its interface to the standard interface; and a data source 

5 component which is automatically inspected by the system to determine what 
available data fields it has, these are exposed to consumers through the standard 
interface as detailed above. 

In a preferred embodiment, the contextualization provided by the system 
and/or framework is accomplished by delegating the final responsibility for data 

10 exposure to an object termed an "InfoModer which is able to choose which of the 
available attributes and methods on an object should be exposed or hidden, and is able 
to add additional attributes or methods. Preferably, the system and/or framework 
further provides facilities supporting transfer of data items between consumers, either 
by user manipulation (cut/paste or drag/drop) or by internal method calls. When a 

15 transfer is initiated, the data item is passed without its contextual characteristics 
. (supplied by an InfoModel) to the receiver. The system and/or framework includes 
facilities supporting the automatic integration of service components (generally 
comprising management facilities such as menu provision or running of user dialog 
routines and may or may not have data source provider and/or user interface provider 

20 components) into an application. Integration is handled by a plug-in manager object 
and set of interfaces such that: each service provider is given the opportunity upon 
loading to query all components (data providers or consumers) existing within the 
application for whether they desire the service, and if so what parameters they would 
like to pass to it. The provider then acts on these responses. Whenever new client 

25 components are loaded, they will be queried and possibly responded to by all services 
loaded within the application. 
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In another embodiment a system for importing partially schematized or 
structured data sources (such as a database system or an XML document) into a 
system as described herein. Any application written using the disclosed system 
and/or framework can then utilize these data sources through a standard interface. In 

5 particular, a system and/or framework for performing all or a substantial portion of 
the functionality outlined herein - if it is in connection with a framework or 
application implemented using a framework falling under categories as disclosed such 
as an infrastructure for mediating between information sources and consumers and 
rapidly assembling applications using them. 

10 Thus the present invention provides a method and apparatus involving two 

subsystems, one which processes the schema information for a data source to 
determine the type and metadata information for information attributes from the 
source, and one which processes the instance information. Preferably, the schema 
subsystem processes schematic information such as the type information contained in 

15 an XML schema document or the column information available from a relational 
database management system and sets up appropriate metadata and relationship 
structure for information elements, but it does not necessarily create any information 
elements. Optionally, additional annotations can be provided by a user in the form of 
a file specifying how to map attributes in the original data to metadata, relationships, 

20 or domain policy attribute or method definitions. Preferably, the instance subsystem 
processes instance information such as that available from an XML document or set 
of relational database rows, for which corresponding schema information can be 
found, and constructs information elements exposed through the standard interface. 
Data consumers can utilize the outputs of these as if they were custom-created data 

25 sources for the type of information described in the schemas. 

In a related aspect, implementation of the invention as described herein for 
both XML and relational databases is provided In the XML implementation, a built- 
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in data type hierarchy for XML schemas is used to provide types to attributes, and the 
element-subelement-attribute structural hierarchy in XML schemas is used to 
determine relationships between information elements. All documents and schema 
references to other documents are followed up to their sources in order to specify 

5 further attribute or relationship information. A user can optionally specify an XSLT 
(XML Stylesheet Transformations) document that maps the typed data fields found 
from the instance-schema combination into attributes with richer metadata and/or 
references to specific domain policies. In the database implementation, the table 
column heading types from the relational database (date, integer, text, etc.) are used to 

10 provide default type metadata to the attributes of information elements derived from 
table rows of the database. A user can optionally specify a mapping between columns 
or sets of columns into attributes with specific metadata. Furthermore, a user can 
define a sequence of queries for which the results are to result in a hierarchy of 
information elements. For example, for each information element retrieved from, for 

15 example, Query 1 , a parameterized instantiation of Query 2 may be applied to retrieve 
elements which will be exposed as the children of the first information element. For 
each of these elements, a parameterized instantiation of Query 3 may be instantiated, 
and so forth. 

Framework Block Diagram 

20 Figure 1 shows a basic block diagram of a framework that is implemented in 

accordance with the present invention. The framework 100 of Figure 1 can be used to 
develop, for example, an information-handling system or application wherein data 
source components 102 and data consumer components 122 are separate and 
independent from each other but can communicate and share data. The framework 

25 100 described herein shall be called the extensible information system (XIS) 
framework. 
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From a developer's perspective, a modular piece of software that handles part 
or all of the data intake or retrieval function is a data source component 102. A 
modular piece of software that handles part or all of either data computation, 
transformation, presentation, or display of information is a data consumer component 
5 122. A conventional information-handling application such as a graphing program 
comprises two major components: one side handles the intake of information from 
storage devices, the network, or user input, and the other side handles the display or 
presentation of the information. There may also be parts of the application that 
perform computations or transformations on the information before it is displayed. 

io XIS Framework 

In the XIS framework 100 constructed in accordance with the invention, there 
may be more than one data source component 102 (also referred to as a source, data 
source, source component, and source object) and there may be more than one data 
consumer component 122 (also referred to as a consumer, consumer object, consumer 

15 component, and data consumer). The data source components 102 provide 

information to other components within the XIS framework 100 via a mediation layer 
1 12, while the data consumer components 122 use the provided information. 

The source components 102 and consumer components 122 that comprise the 
XIS framework 100 are configured such that they communicate with each other in a 

20 manner that is supported by the programming environment in which the framework 
exists, typically by making function calls, via the mediation layer 1 12. In one 
embodiment, the mediation layer 112 consists of a group of application programming 
interfaces (APIs) or class libraries that define a common format for data exchange, 
establishing an information exchange standard. Thus, data source components 102 

25 configured for a different system, application, or framework may still be used within 
the XIS framework if they are "wrapped" in a predetermined way or are suitably 
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modified, as will be known to those skilled in the art, such that they conform to the 
requirements of the data exchange interface of the mediation layer 1 12. 

A relatively simple block of programming code may be produced to translate 
the output of a data source component 102 into the common format as defined by the 

5 mediation layer or API 1 12. In this way, any consumer component 122 may work 
with any data source component 102 regardless of the specific nature or type of 
information involved and regardless of whether the data source component was 
known or anticipated during the design of the data consumer component. Because of 
the XIS framework described herein, the data consumer 122 may also extract 

10 whatever features or sets of information that it needs or can process from one or more 
data source, thereby enabling the data consumer to utilize features and information in 
a generic unspecialized fashion. 

The mediation layer 1 1 2, which is between the data source components 1 02 
and the consumer components 122, exposes the data structure of the data source 

15 components 102 in a manner that is common for the framework, preferably through 
: an API interface. Data consumer components 122 are constructed to use this common 
API, including utilizing the exposed data structure. The data consumer components 
122 are suitable for expressing an extremely wide variety of information types. In 
addition, the data consumers may be constructed to deliver the information received 

20 from the mediation layer to another data consumer component, or to output the 
information received for display. 

Data consumer objects 122 are application or software objects or components 
that use data, or may be said to consume it. Examples of data consumers include 
display programs that display data in tabular format, in graphical mode, in 

25 ■ organizational chart mode, spreadsheet mode, timeline mode (similar to files in the 
format of the "PROJECT" application from Microsoft Corporation), and the like. 
Data consumers may be desktop based, web-based (Internet-based), distributed 
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architecture, interpreted programs, and the like. Data consumer components within 
the XIS framework may provide display, computational, or interactive facilities. In 
the present description, such specially configured data consumer components are 
referred to as "INFOBEAN" objects, as available from the assignee of the present 
5 invention, Polexis, Inc. of San Diego, California, USA. Those skilled in the art will 
understand how to extend the framework 100 to produce desired applications, in view 
of the description herein. 

Figure 2 shows additional details of the mediation layer 1 12 in the framework 
1 00. In the framework 1 00, four special types of interfaces may be exposed to the 

10 data consumer components 122. These four interfaces include Domain Definition or 
Domain Policy 202, Relationship 210, Attributes/Metadata 214, and Change Event 
2 16. In one embodiment, change events are registered within the XIS framework 100. 
These interfaces may be exposed, for example, through class and object libraries that 
may be developed for the XIS framework. With these pre-defined class and object 

15 libraries and APIs, developers of data source components 102 and data consumer 
components 122 may independently develop their own source and consumer 
components, thus facilitating development of information-handling applications or 
systems. An example of a class that may be implemented or written in the mediation 
layer to facilitate development of source and consumer components is illustrated in 

20 Figures 33 A to 33P, which show details of a sample class called ContentlnfoBean. 
Domain definitions or policies 202 (also referred to as domain objects or 
simply domains) are optional within the XIS framework 100. If defined, the 
corresponding Domain methods 212 for such policies are exposed to the data 
consumers 122. Other information about the domain policy may also be exposed, 

25 such as Attributes/metadata 214 and Relationships 2 10 for that particular Domain 
Policy. Attributes/Metadata 214, Change Events 216, and Relationships 210 may also 
be exposed within the XIS framework 100, even if domain policies are not defined, 

21 



WO 02/46916 



PCT/US01/48418 



Relationships show the relationship between data source components* 
Containment, hierarchies, and ad-hoc relationships, for example, may be shown. 
They may be expressed as "members of and references. Relationships are thus 
recognized and may be obtained accordingly, as shown in Figure 14 described further 
below. 

Change events may be used to ensure that all consumer or source components 
that have an interest in another source component's data are notified when changes 
occur. Changes may be notified when attributes, members (or containers), or 
references (or referrers) are added, updated, or removed and when values are changed. 

Once a data consumer component 122 obtains a reference to a data source 102, 
the data consumer component may obtain access to these interfaces 202, 210, 212, 
214, 216 through method calls in accordance with the programming environment of 
the host computer system. The data consumer 122 obtains such a reference typically 
in preparation to consume or use information from at least a particular data source 
102. Examples of such consumer component method calls include: 
get attributes; 

get member and container information elements; 

get referred and referring information elements; 

get unique ID and selection state; 

add and remove instance specific attributes; 

register to be informed of changes to attributes or relationships; 

and 

invoke method calls of a semantically annotated type, described 
below. 

These types of method calls will be familiar to those skilled in the art and familiar 
with the programming environment of the host computer system. 
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Figure 3A is a schematic diagram showing the information about data source 
objects that is exposed by the mediation layer 1 12 in Figures 1 and 2, as well as the 
services available within the XIS framework 100. In accordance with the invention, 
data source components are wrapped with an object that exposes the interface 

5 information for the data source to data consumers through the mediation layer. 

In the preferred embodiment, the wrapper around each data source is an object 
provided by a class called InfoModel. As shown in Figure 3 A, a data source 
comprising a raw data item 351, via the APIs 1 12 as described above, offers a variety 
of information, as shown in the blocks 354, 356, 358, 360, 362, through which data 

10 consumers may gain access to the data source. The information represented by the 
blocks 354, 356, 358, 360, 362 is exposed or may be contained within an InfoModel 
350, which provides an information space for all information available in the XIS 
framework 100 for the wrapped data source component In one embodiment of the 
invention, the data needed by data consumers are accessed via such InfoModels (such 

15 as further illustrated in Figure 28). The wrapper provided by the InfoModel is called 
a LeifDataltem object 352. Thus, the InfoModel is an interface that permits data 
sources and data consumers of the XIS framework to independently share their data. 
In this way, the methods 360, domains 358, metadata 354, relationships 356, and 
other information of a data source object are thus exposed using the InfoModel object, 

20 which may be said to exist in the mediation layer 112, which sets up contexts for data 
consumption. The XIS framework also provides additional data services through the 
mediation layer, such as the Plug-In Service 264 and BeanContext Service 266 
indicated in Figure 3 A. These services provide the functionality listed in their 
respective boxes 364, 366. Other data services may be provided, as desired. 

25 The InfoModel object provides a context for information access, i.e. 5 context is 

instantiated through the InfoModel concept. In this way, security may be enforced, 
considering that the conceptual or real "end-user 1 ' accessing the information is known 
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and thus the underlying data source may be forwarded correctly. Furthermore, 
through this InfoModel concept, an embodiment of the framework may be 
implemented such that attributes and methods may be added or removed by the 
framework user. Original attributes and methods in one context may also be 
5 overridden. 

An attribute is any property of an object In one embodiment of the invention, 
an attribute may be coded with an " AttnTmteDescriptor". An AttributeDescriptor is 
provided by the object or its Translator to describe a property of the object using 
TypeMetaData, e.g., how to display it, how to edit it, its permitted ranges, and the 

10 like. Translators map data source-specific structures and types to an XlS-generic 
representation. Translators are further discussed below. Attributes may also be 
defined using Java introspection or reflection, as discussed further below. 

Dynamic attributes may also be exposed within the XIS framework 100. 
These attributes are attributes that are exposed during run time, such as, for example, 

15 a database query wherein each column is an attribute revealed at run time. The 
mediation layer has a mechanism that captures such information. In the preferred 
embodiment, the XIS framework operates in conjunction with a database management 
application, so that the mediation layer utilizes run time database query mechanisms 
that generate metadata of the data object, such as data table column headings, data 

20 types, and the like. Such mechanisms may be provided, for example, by SQL queries 
and the like. In one embodiment, data consumer applications using the XIS APIs are 
unaware of whether an attribute for a data item is obtained dynamically or statically, 
so that the process is transparent to the application user. 

A domain is a collection of semantically meaningful attributes and method 

25 signatures grouped by their common domain of interest Examples of domains 

include a Display Domain (a domain that describes how to display information) or a 
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Geo Domain (a domain that specifies how to handle geographic information). 
Domains are further discussed below. 

The contextualization provided by the XIS framework system is accomplished 
by delegating the final responsibility for data exposure to an object termed an 
"InfoModel", which is able to choose which of the available attributes and methods of 
an object should be exposed or hidden, and is able to add additional attributes or 
methods. Preferably, the system and/or framework further provides facilities 
supporting the transfer of data items between data consumers, either by user 
manipulation (cut/paste or drag/drop) or by internal method calls. This supports data 
sharing among data consumers. When a transfer is initiated, the data item is passed 
without its contextual characteristics (which are supplied by an InfoModei object) to 
the receiver, i.e., only non-contextual information is transferred. In this way, the 
source data may remain unchanged. 

As illustrated in Figure 3A, a FieldMetaData file 354, a type of metadata, is 
used to represent sorting, subset, and visibility criteria for an attribute. This is further 
explained below in conjunction with Examples 1 to 5, wherein subsets of data are 
shown depending on whether "All Attributes" or "Preferred Attributes" are shown. In 
one embodiment of the invention, default behavior method of domain policy attributes 
may also be overridden. Within this framework, context-specific special attributes for 
flagging whether a data item should be visible or not (e.g., can be used for display 
filtering, including the XIS value slider, tree checkboxes in the map view, etc.) may 
be defined. This may be achieved through the mediation layer by utilizing a user 
interface to modify display processing for the data item. Furthermore, a selection 
attribute that is a context-specific special attribute for flagging whether an object is 
"selected" (and typically should be highlighted) may also be defined. Selected pieces 
of information are often shared among views (context-specific, though), and certain 
operations may be performed on the set of selected objects in a given context 
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The InfoModel objects as described above know how to return a data item (a 
LeifDataltem) given a corresponding raw data source identifier. The InfoModel also 
manages these data items. As indicated in Figure 3 A, an InfoModel may contain one 
or more LeifDataltem objects, each of which provides an interface to a raw data item. 

5 An application developer may use an InfoModel object 350 to get a LeifDataltem 
object 352 in order to use the XIS APIs for accessing the underlying data source in a 
generic fashion. If two different data consumer components ask for a data item (e.g., 
a LeifDataltem) from the same InfoModel for the same raw data source, then both 
data consumers will get the same instance of the LeifDataltem object. InfoModel 

10 objects may also be nested as indicated in Figure 3B. 

Information becomes normalized in the XIS framework so that any application 
can use an object's information by getting attributes and relationships dynamically at 
runtime. Therefore, instead of hard-coding a visualization program to a specific type 
of object, the visualization looks for the attributes it needs to perform its function. 

15 Thus, the developer of the data consuming module may obtain the information needed 
from the XIS LeifDataltem class, which wraps Taw data item objects and exposes 
them to the data consumer through uniform APIs. The visualization can access all the 
information exposed, through the XIS APIs and techniques, as needed. If the data 
source provides AttributeDescriptor objects or translates the properties to domain 

20 attributes, then the information can be interpreted more intelligently in domain- 
specific ways. In one embodiment of the invention, the XIS framework also offers 
APIs and a programming model (or design pattern) that extends Sun's JavaBean 
pattern with XIS information awareness. These extended JavaBeans comprise 
"smarter JavaBeans" that are provided in the XIS framework as the specially 

25 configured INFOBEAN objects and, like JavaBeans, INFOBEANs can be visual or 
nonvisual components, and can be graphically combined in any standard Java 
development environment. 
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InfoModel Class Objects 

In one embodiment, there are four types of InfoModels in the XIS framework: 
BaselnfoModel : 

A single BaselnfoModel is required because it is responsible for creating and 
caching every BaseDataltem (data item) wrapping a Java object (the raw data item 
object). The BaselnfoModel object holds any object used as a LeifDataltem until the 
data item is no longer needed (i.e., until it is no longer strongly referenced). 
SelectablelnfoModel : 
' A super class of BaselnfoModel, this InfoModel delegates to any other 
InfoModel (typically the BaselnfoModel), and creates SelectableDataltems (data 
items that are selectable). The SelectablelnfoModel objects add a selected Boolean 
attribute and delegate to the LeifDataltems from the prior InfoModel. Since the 
BaselnfoModel is a SelectablelnfoModel, all LeifDataltems have a selected attribute. 
This is true because any LeifDataltem is either in the BaselnfoModel itself, or is in an 
InfoModel that is nested in the BaselnfoModel and, therefore, inherits the selected 
attribute from the BaseDataltem. Additional SelectablelnfoModels can be 
instantiated to create independent contexts for selection state, independent of other 

InfoModels. 

AttributeFactorylnfoModel : 

This InfoModel allows AttributeFactory classes to be registered so that every 
time a LeifDataltem is created, it enables attribute factories to add additional 
attributes to each LeifDataltem. 

InfoModelSubset : 

A super class of SelectablelnfoModel and AttributeFactorylnfoModel, this is 
die simplest InfoModel. It delegates to its parent InfoModel and creates 
LeifDataltems that wrap those XIS data items from the other InfoModel. This 
InfoModel does not automatically add any attributes to the LeifDataltems it creates 
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and manages, but simply provides a context in which data items can be managed. 
Each InfoModel "layer" provides a context in which additional attributes can be 
defined, or existing ones can be overridden. Figures 34A to 34D list an exemplary 
Java package that lists various classes. Figures 35A to 35D list the InfoModel 
5 interface. An interface is a contract in the form of a collection of method and constant 
declarations. When a class implements an interface, it promises to implement all of 
the methods declared in that interface. 
Exposing Data 

Figure 4 is a diagram showing how information from source components may 

10 be exposed to data consumers using the mediation layer 1 12. The Attribute/Metadata 
interface 214 of Figure 2 exposes a data item 440, 442 as a set of attributes, each of 
which carry a value and a set of metadata that describes the value. A data consumer 
component 420, 422, 424 may obtain information from one or more data items. 
Similarly, a data item 342 may be used by more than one data consumer 422, 424 via 

15 the mediation layer or API 112. The information blocks 460, 461 show the 
information available to data consumers. 

A data source component 102 may comprise a data source interface (DSI) 
object 412, 414. A DSI object 412, 414 provides a conceptual way to encapsulate 
objects that provide data to the XIS framework 100. A class of a DSI object does not 

20 have to extend or implement any interface. Data is created (instantiated) in DSI 
objects to thereby encapsulate the data and make it available to other objects. The 
DSI itself may also be a data item that simply contains other data items (members). 
The data may be generated internally or extracted from an external source such as a 
database or across a LAN. In addition to creating the data, DSI objects are also 

25 responsible for maintaining and controlling data, such as removing and updating the 
data themselves if such changes are observed in the underlying data used by the DSI 
to create the data. Property change events (216 of Figure 2) may be used by DSIs to 
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communicate changes observed in the original source data items to the listening data 
consumers. 

Any Java object may be a data source component. The Swing JButton, for 
example, is usually a transient object, and not typically retrieved in an information 
5 "system. The Swing JButton, however, may still be a data source, if so desired. 

INFOBEANs as stated above are data consumer components 420, 422, 424. 
They are specially configured objects that behave like JavaBeans that process and 
manipulate data in a generic fashion. They are also capable of interpreting and 
optionally displaying XIS data items. INFOBEANs use the XIS framewoik API's to 
10 gain access to information about data items. 

As previously stated, any Java object may become a data item 440, 442 within 
the XIS framework 100. To make a data item out of JSlider (javax.swing JSlider), it 
simply must be added to an INFOBEAN (data consumer component). Table II below 
provides programming code that makes a data item out of javax.swing JSlider, thus 
15 exposing the information blocks 460, 46 1 shown in Figure 4. 



Table H 

Jslider slider - new Jslider(0,l 00,50); 
tablelnfoBean.addRawDataltem(slider); 



The first line of code creates a data item out of JSlider. The second line of 
code adds the JSlider created in line i to the TablelnfoBean object (an INFOBEAN). 
20 In this framework, JSlider knows nothing about the XIS framework, however, all its 
attributes are exposed, to be used and modified. 

There are basic steps that must be performed when creating a DSL First, 
before any code is actually written, a determination must be made as to how the 
original data or data source is to be obtained (e.g., will it come from a database, a flat 
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file, an EJB (Enterprise JavaBean), read from a socket, etc*). This step is performed 
prior to and independent of coding the DSL Once the data source has been 
determined, it must be decided what attributes of the data source should be exposed 
within the XIS framework. 
5 The DSI component within the mediation layer of the XIS framework has the 

capability of exposing the attributes of a data source. In one embodiment, assuming 
that the data source is a Java object, the attributes to be exposed are determined 
through Java introspection. Introspection is a way to determine a bean's properties, 
methods, and events. Those skilled in the art will understand that a bean is a reusable 

10 software component, which may be combined to build applications. In this scenario, 
no additional code in the consumer component needs to be written. Although 
convenient, this approach is limiting, as it does not allow control over which attributes 
are exposed, and does not allow the user to define custom visualization components or 
express semantics. Furthermore, it requires the Java object to conform to the 

15 JavaBean design pattern. 

Another approach to determining which attributes of a data source should be 
exposed involves writing new code. This approach embeds XlS-aware code directly 
into the Java object. This allows the component developer to directly specify details 
such as the attributes (e.g., via AttributeDescriptor) to be exposed along with their 

20 metadata, the Domains to which the DSI subscribes, which Domain methods are 
exposed with what implementations, and more. Writing new code enables greater 
control over the data item (as opposed to the introspection-only case) and provides 
more flexibility in dealing with any Java object rather than just JavaBean objects. 
One limitation of this approach is that the relationships between data items may not be 

25 directly specified. 

Another approach for exposing attributes is to create a Translator class. An 
application developer may place any of the XlS-aware code for exposing attributes, 
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Domains, and the like in this class, as specifying relationships to other data as 
members or as references. This is described further below, in conjunction with the 
description of Figures 21 to 23. 

Referring back to Figure 4, a data consumer 420, 422, 424 may access a data 

5 source via a data source interface (DSI) object defined in the mediation layer 1 12. 
Communication between the DSI objects 412, 414 and data consumers 420, 422, 424 
in the framework 100 is mediated through a set of application programming interfaces 
(APIs) 112 that remain independent of the actual contents and types of the data 
sources. Such APIs are contained in class libraries. 

10 Using the framework 100, a data consumer 420, 422, 424 (for example, an 

INFOBEAN as shown in Figure 6B) may be able to use heterogeneous data sources 
and, thus, eliminate the need to write a particular display software object for each 
particular data source. Within this framework, any data consumer object or 
application may use the data source object's information by getting attributes and 

15 relationships dynamically at run time. Instead of hard coding a visualization to a 
specific type of data source component, the visualization object or data consumer 
looks for the attributes it needs to perform its function. Thus, in this framework, 
developers for source and consumer objects may work independently of each other. 
The DSI object may create any data structure containing members and 

20 references, and may expose any part of that data structure to the framework or system 
100 if it is desired. Since there are no requirements involved to be a data source, a 
visualization bean can also be a data source. The data source can consume data from 
other data sources, and can create new data based on what it has learned. For 
example, DSI objects may be coded to use data source from an RDBMS, e.g., systems 

25 such as provided by Oracle Corporation of Redwood Shores, California, USA and as 
provided by Microsoft Corporation of Redmond, Washington, USA through their 
"ACCESS" application or SQL Server. DSI objects also may use data sources such as 
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XML format data, tabular data (e.g., spreadsheet data such as spreadsheet files in the 
format of the "Excel" application from Microsoft Corporation), email, schedules (e.g. 
schedule data in the format of the "PROJECT" application from Microsoft 
Corporation), data following the SNMP (simple network management protocol), and 
5 the like. 

Objects created by DSIs are considered to be raw objects in the XIS platform. 
These raw objects become normalized objects within the XIS framework when they 
conform to the mediation layer or the API 1 12. In one embodiment, when these raw 
objects are added to an XlS-enabled environment, the XIS framework wraps them 

10 with a normalized object called a LeifDataltem (see Figure 3A) and holds the data 
item in one or more InfoModels. The raw data item could be a simple Java object 
(that does not know anything about XIS) or it can support XIS with direct references 
to AttributeDescriptors and other metadata that are recognized by XIS. The 
mediation layer is implemented in software and runs in-process. It is also exportable 

15 to serve as a distributed middleware if required by a given application. 

An attribute is any property of an object. An attribute 474, 475 typically 
includes identity (ID number) 476, 477, name of the attribute 478, 479, value 480, 
481, and the metadata type or Type Metadata 482, 484, and a description 484, 485. 
Attribute names 478, 479 may be the table column header or field name in an 

20 RDBMS. The description of the attribute 484, 485 may be plain text that explains the 
attribute. The value 480, 481 may be expressed as a number, string, or other basic 
data type, or may be expressed as a complex, structured object in itself. 

Referring back to Figure 2, the Attribute/Metadata interface 214 provides for 
fine-grained exposure of an information element or data item 440 442 (Figure 4); by 

25 "fine-grained'* is meant that the data item is broken down into a number of aspects or 
characteristics (the "attributes") which are simpler data elements. These might be 
numerical values, strings, arrays, or anything else that can be represented by a 
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software object (but is simpler than the original element). If a data consumer 412, 
414 is not able to handle the entire data element, it may be able to handle some of its 
attributes and therefore may be able to do something useful with it, unlike most 
systems providing interfaces for data integration, which require the entire interface to 

5 be implemented to enable any data usage. 

The Attribute/Metadata interface 214 also makes each attribute self-describing, 
to a limited extent. In accordance with the invention, a data consumer designed 
without regard to a particular type of attribute is still able to display and perform 
limited operations with those attributes by using the metadata types. For example, a 

10 data consumer object or INFOBEAN, which displays an X and Y chart of cost of 
living (expressed as a numerical value) versus geographical location (expressed as a 
territory or state character string, e.g., "California"), may be used to display a different 
set of data contained in another data source component or data item, so long as the 
metadata types of the different sets of data are compatible with the X and Y chart In 

15 particular, a data consumer component that renders and edits information may still be 
executed, the default value substituted in cases of absence, and statistical 
summarization performed, even if the data consumer component is processing a 
different data source component Other operations are possible and additional 
metadata may be provided by developers for any identified classes of information 

20 elements (such as number, array, geographic entity, etc.) desired. Because of this, 
data consumer developers may identify the type of auxiliary information or 
procedures provided by the consumer component and then define the interface 
according to which other developers creating data sources should provide or expose 
their metadata. 

25 In one embodiment, any property or attribute of an object may be defined with 

an AttributeDescriptor programming code. When a data source object is enabled 
within the XIS framework, the computing system automatically creates 

33 



WO 02/46916 



PCTAJS01/48418 



AttributeDescriptors for JavaBean properties and for some public properties. A 
JSlider object, for example, is a JavaBean. JavaBeans have properties that are defined 
by the get<property> and set<property> methods. If the object is a JavaBean and 
provides a Beanlnfo, then it will be honored and treated according to the JavaBean's 

5 specification for Beanlnfo classes. Only properties listed in the Beanlnfo appear as 
attributes. If metadata types, further discussed below, support the property's type, 
then they appear as attributes for that data item. Any properties that do not have 
TypeMetaData support become data items themselves (using the same reflection and 
introspection rules) and are listed in the data item's reference array, retrieved by the 

10 LeifDataltem getReferencesO method (i.e., a method to obtain the references). 

Translators translate various data item classes, thereby enabling seamless integration 
of various data items without code modification. Translators may also be added to 
augment object reflection and introspection, i.e., by developers directly specifying the 
properties of an object 

15 Table III below lists exemplary programming code to define attributes. Table 

III shows how to define a SIZE attribute. 



Table m 

public static AttributeDescriptor SIZE; 
static { 

AttributeDescriptorFactory factory = 

AttributeDescriptorFactoiy.getAttributeDescriptorFactoryO; 
SIZE = factory.createAttributeDescriptor( 

"size", Your.class, 

new NumericTypeMetaData( M Size", long.class, 
UnitsOfMeasure.BYTES, 6)); 
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} 



Metadata are data or information regarding data, for example, data type, field 
name, length, value restriction, color, and the like. In practice, metadata are used to 
define the structure and meaning of data objects in tools, databases, applications, and 
other information processes. The data type metadata 482, 483 encompasses both 
procedural and declarative information, including (as appropriate for the value) but 
not limited to the following: 

unit of measure (from the provided unit of measure software 
object, converters to/from other units are accessible); 
content length; 

default or maximum character length or precision of numbers; 
data quality (a rating given by the provider of the data); 
default value (given by the provider of the data type); 
constraints (e.g., numeric range or list of acceptable values); 
formatting; 

comparator function (a procedure which takes two items of the 
data type in question and returns whether one is to be ordered 
before, after, or the same as the other); 

validation function (returns 'true' or 'false 1 depending on whether 
the value for the attribute passes a certain test or set of tests, tests 
are developer-definable based on an interface which takes a 
software object providing a value and returns a Boolean value, 
but several reference implementations are provided, such as one 
to determine whether a number is within a specified range; 
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in the property sheet (and the display button "Apply" is pressed), the chart 
automatically updates. Similarly, right clicking on the part of the chart coiresponding 
to a data item enables a user to bring up its property sheet. In this embodiment, this 
kind of coordination is maintained automatically within the XIS framework through 

5 the use of the JavaBeans event mechanisms. It should be noted that when the 

application is run or executed, the color of the chart does not match the one set in the 
property sheet. This is because, although the PropertySheet recognizes that any field 
of type "java.awt Color" is displayable and editable as a color, the chart has no way of 
knowing which color field (if there are more than one) should be used. This may be 

10 solved, however, within the framework by using standardized Domain Attributes. 

In one embodiment of the invention, Translators are used within the XIS 
framework. As described earlier, a DSI exposes data information within the XIS 
framework for data consumers to use. Java reflection and introspection may be used 
to obtain attributes specified in simple objects and JavaBean, respectively. The XIS 

15 framework first searches for a Translator class for the data source object. Translators 
are therefore optional considering that the attribute values and attribute descriptors 
may directly be obtained from an object Translators may also be used in order to 
keep the object's class simple so that it is capable of being used in non-XIS 
environments. 

20 In an embodiment, Translators are somewhat similar to the Beanlnfo class in 

JavaBeans. Like the Beanlnfo class, the name of the class must begin with the name 
of the data class followed by "Translator". For example, a DSI class named 
PlanObject Java would have a corresponding Translator class 

PlanObjectTranslator.java. Also, similar to Beanlnfo classes, Translators must reside 
25 in the same class space in which the DSI is located. For special circumstance cases 
such as non-localized objects or custom Translator definitions, a Translator registry, 
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e.g., TranslatorRegistry, may be used to register a Translator for a given data item 
class. 

Table VDI below shows an exemplary code to register a Translator within the 
XIS framework. 



Table VHI 
// register the translator for File objects 
TranslatorRegistry.getTranslatorRegistryO 

,registeiObjectSchema(PlanObject.class, 

PlanObj ectTranslatorxlass); 



The above code, as well as all code discussed herein, is provided to illustrate 
the functional behavior described herein. One of ordinary skill in the art will be able 

10 to produce the code, for example, to create classes, objects, APIs to affect this 
Translator registry. 

When the value of an attribute is requested from a data source component, 
using the mediation layer, the value from the attribute methods specified in the 
Translator, if any, is exposed. If the Translator does not exist, then the method in the 

15 object is invoked, i.e., the get+attribute method within the data source object. The 
Translator may directly invoke the object's methods as well. The Translator may also 
be used to wrap legacy code. For example, if the object class is a legacy code, which 
may not be modified, and has a color property, a Translator may be written to return 
the value of the color, for example, for the DisplayDomain.color attribute. In this 

20 way, the information may be accessed without modifying the original legacy code. 
The data in the data source object in effect has been normalized or tailored to the 
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domain policy specified. The XIS framework in this embodiment provides the ability 
to integrate existing data item classes without modifying them. 

To integrate a data item class into the XIS framework, an accompanying 
Translator class should be provided. In this Translator class, the data source 
5 developer provides code that reaches back into the data item's class to expose its 
properties. It also serves as a way of normalizing access to these properties by 
imposing a common interface for all Translators to implement. 

Translators have two primary functions: 

(1) Translators provide an intermediate method from the caller of an attribute 

10 "get" or "set" method to the data source object, enabling a developer to translate the 
value from its internal representation to a representation understood within the 
framework, particularly, by the data consumer components. For example, an object 
may store a default color as a string color name, but the Translator may convert that 
color to a java.awt, Color object 

15 (2) Translators also enable a developer to define attribute types more precisely 

(e.g., via AttributeDescriptor code, which provides detailed TypeMetaData and may 
map attributes to specific domains). This resolves any ambiguity in the attribute type. 
It should be noted that reflected properties that are converted into XIS attributes cany 
minimal semantics, which contributes to the usefulness of the XIS framework. For 

20 example, "float getDegrees() n by itself does not imply whether it provides an angular 
measure or a temperature measure, nor does it imply that the valid range is from 0 to 
360 or from 0.0 to 2.0 pi for angular measures, or distinguish between Fahrenheit, 
Celsius, or Kelvin for temperature measures. 

Translators also enable developers to convert objects that do not follow the 

25 JavaBeans get/set API design pattern. For instance, a data item could be implemented 
as a mapping of attribute names to values (e.g., String, Integer, Double, and Boolean). 
The Translator may map actual XIS attributes to these key/value combinations, 
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making XIS data items appear as if they were generated from the more typical 
JavaBeans-style objects. Example 3 shows how a Translator may be implemented in 
the XIS framework. 
Example 3 

5 Example 3 application is contained in three source files listed in Figures 21, 

22A, 22B> 22C, 23A, 23B, 23C, and 23D. The resulting outputs are shown in Figures 
24Aand24B. 

Example 3 functions similarly to Example 2 above, but enable finer control 
over the data item attributes exposed within XIS. In particular, the HelloWorld object 

io is explicitly wrapped in a Translator rather than simply feeding it to XIS and letting it 
rely on reflection to display and manipulate the data. This allows some properties of 
the raw data item to be hidden, and allows other ones to be better "understood" within 
XIS. The Hello WorldTranslatorjava file contains the Translator. 

Referring to Figure 21, the property change event-handling portion of code 

15 1 506 found in Figure 1 8A has been removed from the set methods- These functions 
are now handled in the Hello WorldTranslator class (Figures 22A-22C), which is 
registered with XIS by the TranslatorRegistry static call at the beginning of that class. 

Referring to Figures 22A to 22C, this file contains the HelloWorldTranslator 
class 2202 that wraps the HelloWorld object When an INFOBEAN encounters a raw 

20 data item, it ultimately accesses the raw data item through a Translator's methods, if a 
Translator exists. In one embodiment, all Translators are subclasses of the 
com.xis.leif.im.Translator class, which provides an infrastructure that facilitates the 
use of attributes already defined or set-up in an XIS Domain. Such attributes have 
type metadata predefined for them, and many XIS INFOBEANs automatically access 

25 and utilize the metadata and the attributes themselves. 

The first member variable 2204 of the HelloWorldTranslator class lists the 
predefined XIS domains from which attributes are taken. In order to use an attribute 
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not in one of these domains, it may be necessary to provide a separate metadata for it. 
The second member variable 2203 defines an array, which lists auxiliary information 
on the fields, in this case, whether they are displayed by default in the property sheet 
display. The getFieldMetaDataArray method 2206A and 2206B fills this array, if 

5 necessary, with the default metadata for the fields that are exposed by the get and set 
methods further listed below in the source file. The exception to the defaults is that 
the "course" attribute 2208 is not visible, i.e., it is not displayed under the "Preferred 
Attributes" on the property sheet. It is displayed, however, when the "All Attributes" 
option is selected. Other things that may be set (but are not in the source file) include 

10 the sorting order and rank when multiple data items of this class are listed together, as 
in a table. 

The ensuing get and set methods 2210 define the attributes that the rest of the, 
XIS objects can see. In general, this refers to the enclosing raw data object, but this 
need not always be the case. For example, here, the HelloWorld f s integer Value* 

15 property is map to the 'speed* attribute, which takes its metadata and its type (double) 
from the Movement domain 2212. The Movement domain has previously been 
defined. By handling conversions within the Translator, the rest of XIS "never 
knows" that there is really an integer value underneath. 

All change event propagation is handled through the request objects passed 

20 into the set methods 22 14. Similar to Example 2, all XIS objects using the same data 
item are notified of the change. 

Referring to Figures 23A through 23D, the TestHarness code is largely 
unchanged from Example 2, but at the end it includes a separate class that 
demonstrates how attributes maybe altered on a data item that includes a Translator. 

25 In general, the procedure is to obtain, first, the LeifDataltem corresponding to the raw 
data item, then a "domain wrapper" that wraps this and enables access to attributes 
that come under that domain. Internally, the domain wrapper calls methods on the 

64 



WO 02/46916 



PCMJS01/48418 



Translator, but externally it presents an interface to the developer that depends only 
on the domain and not on the particular LeifDataltem being wrapped. 

The code in the Accelerate class is a standard thread implementation that uses 
the wrapper to successively change the HelloWorld data item's speed attribute. In 

5 other embodiments, this attribute may be altered by any portion of the program that 
has access to the data item. Because the wrapper eventually calls the Translator, the 
change events are propagated appropriately. 

The Example 3 application, similar to Example 2, displays two windows~a 
property sheet and a chart. Example 3 shows that the property sheet may be made to 

10 display more properties (in this case, the "course" attribute) by selecting "All 
Attributes" from the top menu, which ignores the "preferred" setting in the 
FieldMetaData. The attributes all have reasonable names, which come from the 
metadata stared in the domains. Finally, if the "Pen Color" attribute is edited, the plot 
changes color accordingly. This is because the Chart INFOBEAN recognizes and 

15 uses the "Pen Color" attribute from the Display Domain if it finds one on the data 
item. Because of the various wrappers employed, it does not matter what kind of 
object is eventually underneath or what other attributes it has; as long as the "Pen 
Color" attribute is found, it will be used. 
Example 4 

20 Example 4 contains two source files namely HelloWorld and TestHarness. 

Figures 25A to 25C list the HelloWorldjava source file. This example shows 
translation without a Translator class. The resulting output is a property sheet 
INFOBEAN and a Chart INFOBEAN. Figure 26 shows the property sheet InfoBean, 
but the ChartlNFOBEAN is not shown. The HelloWorldTranslator.java file from 

25 Example 3 is ehminated. Similar to above, the Hello World.java file has been marked 
such that changes from Example 3 are marked by open and close commented braces. 
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The Java source files enable some of the same fine control over the attributes 
exposed within XIS (see Example 3) without using a separate Translator class. If a 
developer has control over the Java code for the data source, the overhead of using a 
Translator may be eliminated by building some of its functions directly into the data 

5 source. It may, however, still be desirable to use a Translator because this avoids 
building any XIS- specific code into the JavaBean created and enables the code to be 
more streamlined for use in non-XIS contexts. 

Figures 22 A to 22C contain the Hello World code, which include some of the 
code from Example 3, with some additional code for exposing attributes and 

10 providing field metadata as the HelloWorldTranslator class in Example 3. In fact, 
almost everything may be done from within this data item class that could be done 
with a Translator except for two things. First, attributes cannot be hidden from XIS-- 
everything with a get() method is exposed. Second, Translators may be used in 
conjunction with security features, for example, embodied in the XIS framework to 

15 restrict access to visible properties in a generalized fashion across all data items. 

The first portion of code 2502 provides methods for XIS to obtain information 
on which data item properties have attribute information provided for them. The XIS 
components first introspect on the data item to find its properties, then try to call the 
get(property name)Descriptor for each property. For those instances where this fails, 

20 the XIS component may provide its own attribute descriptors where it recognizes the 
type of the attribute. For example, the property sheet recognizes Color, Numeric 
(various subtypes), Date, and String attributes. The next portion of code 2504 
initializes a PropertyChangeSupport instance, because property change events must be 
handled here, similar to Example 2. 

25 Following this are several methods unchanged from Example 3, but the set() 

methods have been altered to resemble those from Example 2 in which property 
change events are fired. Next, there are several new getQ and setQ methods which 
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expose the properties with the same names as the Translator did in Example 3. These 
names correspond with the getAttributeDescriptor methods listed above in the code, 
and the XIS components interpret them accordingly. These properties show up as 
preferred attributes in the property sheet, whereas those properties without 

5 corresponding attribute descriptors become nonpreferred attributes. 

The portion of new code 2506 following this provides field metadata for this 
raw data item. This program code is almost identical with those in the Example 3 
HelloWorldTranslator, except that both the variable and the method are now static, 
and the "Course" attribute removed to reduce clutter. 

to The TestHaraess file for Example 4 is generally unchanged from Example 3, 

except the code to register a Translator is removed. The portion of program code 
2302 in Figure 23A is removed in this example. 

This Example 4 application is largely similar to Example 3, except that if the 
"All Attributes" option is chosen under the property sheet, then the previously 

15 unexposed "value", "myColor", and other attributes appear. The chart is also able to 
display the "value" and "ID" properties. 

Figure 26 shows a window display of the property sheet output from the 
Example 4 application. 

Processing Flow for Exposing Data 

20 Figure 27A and Figure 27B show a flow diagram of how information about a 

data item, e.g., a data item as shown in Figure 5, is exposed to data consumer 
components. In the preferred embodiment, data exposure within the system may be 
accomplished by one of three methods, described further below. There are two 
primary functions to be performed: (1) interfacing with an internal or external data 

25 source such as a set of disk files, a database, or a web service; and (2) exposing the 
resulting data according to the standard interface outlined above, e.g., following the 
domain interface, relationships interface, and the like. 
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In the first method of exposure, one software component performs both 
functions; in the second method, separate software objects perform the two functions; 
in the tod method, which is only implementable in an object oriented programming 
language that provides self-analysis facilities, such as Objective C or Java, the . 

5 exposure function is performed automatically by the system. More particularly, in the 
first method, a data source interface (DSI) software object is written that connects to 
an external data source such as a local file system, an Internet site, or an RDBMS. 
The DSI object converts the information provided by the external data source into the 
information representation or data item that may be consumed by data consumer 

10 objects as described above. In a preferred embodiment of the invention, the data 
source DSI objects are from the LeifDataltem class. 

In the second method, the API of an existing software data object is accessed 
. by a Translator object, which then exposes the information to other data consumers in 
the representation format discussed above. This arrangement is referred to in the 

15 object oriented design literature as an Adapter or Wrapper pattern. See, for example, 
Gamma, E., Helm, R., Johnson, R., Vlissides, J. (1995); Design Patterns: Elements of 
Reusable Object Oriented Software; New York: Addison-Wesley. This is generally 
referred to as "wrapping". More precisely, a data consumer component requests 
information from the Translator object, which then converts the request into 

20 something the original data source object can deal with. The consumer then converts 
that object's response into the appropriate format for a response to the original call. 

The third method applies the facilities within a self-analysis-capable 
programming language such as Java or Objective C. This type of programming 
language enables an object to determine the available data fields and function calls 

25 afforded by another object while an application is running. In the preferred 

embodiment implemented in Java, the queried object must be a "JavaBean" according 
to Sun Microsystem's suggested convention, with "get()" and "setO" method calls. 
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Each data field available through one of these calls, or by virtue of being a "public" 
variable, is examined, and the resulting type information is used to expose both the 
field's value and appropriate metadata to data consumers. If the field is a numeric 
type (double, Double, float, Float, Integer, int, long 3 or byte in Java), it is exposed as a 
decimal or integer with an "unknown" unit of measure. If the field is a string (String 
in Java), it is exposed as a text element If the field is a complex object, it is exposed 
as a linked element via a reference (discussed above), unless a special class has 
registered to handle the complex object type within the application context or XIS 
framework. 

In another embodiment, in addition to the facilities for exposing data, the XIS 
framework provides an apparatus for allowing application context to affect how 
information is exposed. This is illustrated in Figures 27A, 27B, and 28, described 
further below. The attributes, methods, and relationships available for a given data 
source are determined by a surrounding structure called an InfoModeL The 
InfoModel connects the pieces of the XIS framework together. It is an interface 
comprising an object that knows how to return data item information. See also Figure 
3A discussed above. 

In another preferred embodiment, an application comprises one or more Views, 
each containing and providing an InfoModel to one or more data consumers, termed 
INFOBEANS as described above, which may provide display, computational, or 
interactive facilities. All of the Views are in turn managed under a single ViewHost, 
which provides the global application context Conceptually, a view represents a 
single perspective of the current data. One single perspective (or view) could be quite 
different from another because of the ability to add/override attributes in a view. 
View creates a new InfoModel that in turn creates new LeifDataltems that are used 
within that view. This is done to separate context sensitive attributes between an 
InfoModel and another View, INFOBEAN, or InfoModel. Views are also used as a 
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controller of one or more INFOBEANs by managing the data flow to each individual 
ENFOBEAN. All Views are also by definition INFOBEANs since they manage 
information flow with generic means. The ViewHost is used to manage the complete 
set of Views and INFOBEANs, thus presenting each view to the user in a uniform 

5 fashion such as frames, windows or other display mechanisms. 

Figure 27A and Figure 27B show a flow chart of a data exposure facility 
within the XIS framework constructed in accordance with the present invention. The 
diagrammed operations will occur when the XIS framework is loaded into program 
memory of a computer system that supports an object oriented programming (OOP) 

10 environment, as will be understood by those skilled in the art. In the first processing 
step, at block 2702, a data source object is registered within the XIS framework of the 
computer system. When a data item is brought into the framework, it is exposed to 
data consumer objects, e.g., via an InfoModel, typically via one of three methods. The 
first operation is to determine whether a Translator object is available and whether the 

is Translator object is registered for the raw data object type. This processing is 
represented by die decision block 2704. 

If the Translator is available, an affirmative outcome at the block 2704, then at 
block 2760 the data item attributes, methods, and Domains are obtained via the 
Translator. If the Translator is not available, a negative outcome at 2704, then at 

20 block 2706 the data item object is scanned to find the data object's methods. The 
scanning may be accomplished with facilities of the OOP environment of the host 
computer system, such as InfoBeans. 

After the data item object has been scanned at block 2706, the system next 
checks to see if the data item includes an XlS-standard data exposure interface (that 

25 is, a predefined interface known to the XIS framework). If the standard interface is 
available, an affirmative outcome at block 2714, then at block 2762 the data item 
object attributes, methods, and Domains are obtained from the data source object 
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itself. The system then checks for references to Domain Policies at block 2763. If 
there is no standard interface available at the decision block 2714, then processing 
moves to the block 2764, where the fecilities of the programming language of the 
OOP environment are used to interrogate the data item object to determine the object's 

5 accessible data fields. Processing then moves to exposure attribute processing via the 
off-page connector B to Figure 27B, described below. 

Returning to block 2762, after the data item attributes, methods, and Domains 
are obtained, a check is made for Domain Policy references at the decision block 
2763. If there are references to Domain Policies, an affirmative outcome at the 

10 decision block, then at block 2765 a check is made to determine if there is 

FieldMetaData override for a Domain. If there are no Domain overrides, then at 
block 2710 the definitions from the referenced Domain Policy are used for the 
attribute metadata. The processing then moves to exposure attribute processing via 
the off-page connector A. If there are Domain overrides, an affirmative outcome at 

15 block 2765, then at block 2716 the system uses the definitions included with the data 
item object Translator for the attribute metadata of the data item. The processing then 
moves to exposure attribute processing via the off-page connector A. Referring back 
to block 2763, if there were no references to Domain Policies, then processing 
proceeds straight to block 2716 to obtain the attribute metadata definitions and then to 

20 the exposure attribute processing via the off-page connector A to Figure 27B. 

Turning to the processing of Figure 27B via the off-page connector A, the data 
item attributes are exposed to the local InfoModel class (i.e., a DSI object). Next, at 
the decision block 2770, a check is made to determine if the data item has any 
dynamic attributes. If the data item does, then at block 2772 the framework 

25 processing adds the dynamic attributes to the available data item attributes. If the data 
item has no dynamic attributes, or after any dynamic attributes have been added, 
processing moves to block 2773, where the system checks to determine if a Translator 
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was provided (registered) for the Data Source object If a Translator was provided, 
then at the decision box 2775 the system checks to determine if reflection has been 
requested. Those skilled in the art will understand that reflection is an operation that 
is provided by most OOP environments, such as by Java. 
5 If reflection is to be performed, then processing returns to Figure 27A via the 

off-page connector C, whereupon the Data Source is scanned. If reflection is not to 
be performed, or if no Translator was registered (a negative outcome at block 2773), 
then processing moves to the decision block 2774. At block 2774, the system checks 
to determine if the data item has registered any extended Translators. If there are no 

10 extended Translators, then at block 271 8 the data item attributes are derived, added, or 
hidden, depending on the data context gleaned from the DSL The data item is then 
folly exposed to data consumer components for use (block 2790). If there are 
extended Translators, an affirmative outcome at block 2774, then processing returns 
to Figure 27A via the off-page connector B to obtain the information from such 

15 Translators (block 2760). 

Figure 28 is a diagram showing how InfoModels provide contextualization 
within the XIS framework* The initial "raw" object (e.g., Java object or data from 
RDBMS) provided by the data source is exposed through mediation by successive 
"wrapping layers" of other objects, which determine which fields are visible, and 

20 possibly performs conversions or consolidations. Each "View" within the XIS 

framework, which contains one or more 'TNFOBEAN" consumers, carries with it its 
own context. Feeding a data source component to a consumer component places it 
within that context 

When a data element provided by a data source is introduced to an InfoModel, 
25 the InfoModel actually provides a new element derived from this one to consumers. 
This derived element provides the actual data source interface discussed above. The 
attributes, type metadata, and methods provided for the element are first determined 
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as described below under "data exposure facilities". Then the InfoModel inspects the 
results and decides whether to add or derive any new attributes, or to hide existing 
attributes. Once the data is added to an InfoModel (discussed below), it may be asked 
for by other components for processing and visualization purposes. 

5 In another embodiment, the ViewHost, a data consumer component, provides 

facilities allowing interactive cut and paste and drag and drop of information elements 
between different consumer components. When a cut-and-paste or drag-sand-drop 
occurs, each information element is decontextualized and then recontextualized inside 
the new InfoModel into which it is placed. This means that some attributes 

1 o previously available may be removed, whereas others, more appropriate to the 
functions of the recipient consumers), may be added. 

Referring back to Figure 28, this figure shows how multiple InfoModels work 
to share references to raw objects. This figure also illustrates how an INFOBEAN 
and/or a DSI adds objects to the InfoModel to obtain data items. The DSI 2815 

is creates an instance of source raw data item (e.g., Java object) 2830, The original 
source objects are maintained by DSI and one or more InfoModels have references to 
these source objects. The raw data item 2830 is provided to or may be used by an 
INFOBEAN (data consumer) via the addRawDataltemQ method. (Please refer to 
Table HI above. The second line of code shows that the source object is added to the 

20 TablelnfoClass.) 

The INFOBEAN 2820 requests the data item for the raw object 2835 (which 
was the source object 2830) from its InfoModel or the BaselnfoModel. The 
BaselnfoModel as discussed above is responsible for creating and caching every data 
item (wrapping any object). Each InfoModel is considered to contain a subset of data 

25 items from the entire set of data. The InfoModel is a view of the BaselnfoModel, 
thus, there may be data items in the BaselnfoModel that are not present in the 
InfoModel used by the INFOBEAN. The circles 2828 shown in the InfoModel 2805 
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represent attributes, domains, relationships, etc. from the BaselnfoModel. For 
example, Figure 6 contains a list of information that an INFOBEAN may obtain about 
the Person object, in this case 2830, 2835, through the LeifDataltem API. In addition 
information from nested InfoModels are inherited. An InfoModel 2805 also always 

5 adds new items to the BaselnfoModel, e.g., common attributes such as "selection" are 
delegated. These new items are also exposed to the INFOBEAN as shown by the 
number of circles in 2840. 

The BaselnfoModel 2810 returns the raw data object 2845 to the InfoModel. 
The InfoModel 2805 returns a data item 2840, which exposes the information, for 

10 . example, shown in Figures 4 and 5 to the INFOBEAN 2820. A data item 2845 (see 
Figure 4) is returned, which may have been created or may have already existed in the 
InfoModel. 

In the XIS framework, as shown in the InfoModel, attribute and method 
"requests" mechanisms are available. Standard mechanism to retrieve the current 

15 value of any Attribute, or set the current value, if the Attribute is mutable, may also be 
. easily implemented. In one embodiment, this mechanism also enables a standard 
syntax and mechanism for the invocation of any domain method. 

These attribute and method "request" objects contain all of the information 
necessary for the data source to fulfill the requested task. It contains the actual 

20 ("raw") data item whose attribute value is being sought or set (along with the desired 
new value) 3 or whose domain method is being invoked. They also contain contextual 
information, such as the current User, allowing data source developers to implement 
foil user-based information access and security controls, and a context for obtaining 
services (implemented through the Java "BeanContext" APIs). This is significant 

25 because it enables the process of executing methods and/or getting or setting values to 
leverage services "in context" such as the current data view (or window) through 
which to interact with the user. These request objects also contain contextual "data 
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item" (e.g., LeifDataltem), as opposed to the "raw" non-contextual data item, from 
which to get additional or overridden values or execute additional/overridden 
methods, if appropriate to the task. In another embodiment, these "Request" objects 
are not only passed when getting/setting values, or executing domain methods, but are 

5 also passed to all other 'Translator" methods that take and may need to access or 
manipulate the data item. The "Request" object not only provides context, but also 
ensures that the DSI (via the Translator) always has what it needs (particularly, the 
User information) to manage its security constraints, if any. 

A data item locking mechanism for obtaining, holding, and releasing a lock on 

10 an individual data item may be implemented in accordance with the present invention. 
This implementation is best defined by the data source provider, by implementing 
such locking mechanism in the data source, itself. Ad hoc implementations for data 
sources that do not provide native locking may also be done via the DSIs. This 
mechanism enables DSIs to implement multiple changes atomically (as one 

15 transaction) by effecting those changes at the time of the release. In addition, a 
"rollback" feature for atomic changes is possible through the "revert 1 ' capability, 
which generally releases the lock without affecting the previous changes. This 
locking mechanism may also be leveraged to lock multiple objects simultaneously, at 
the discretion of the DSI, by associating the lock with a DSI-defined 'lock object" 

20 which can either be associated with a single data item or with a group of data items, as 
appropriate. Using the DSI API, this provides to data consumers a single API for 
dealing with locking implementations. 

Figure 29 shows an embodiment of a "plug-in manager" called PluglnManager 
of the present invention. The programming framework embodied in this invention 

25 includes a "plug-in manager" which provides extensible communication between 
services and components within an application. Plug-ins are software modules that 
add a specific feature or service to a larger system (i.e., plug into a larger application 
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to provide functionality). For example, there are a number of plug-ins for the 
NETSCAPE NAVIGATOR browser that enables the browser to display different 
types of audio or video messages, e.g., SHOCKWAVE by MACROMEDIA. 

A "service" is capable of obtaining information on a data consumer or data 
5 source component and capable of using that information to provide specific facilities 
. to the application as a whole. Examples of such facilities include addition of entries 
to a top level application menu, loading MIME types into the global MIME type map, 
and running of scripts upon loading or unloading of data sources or consumers. The 
plug in manager loads new services at initialization and also at any time through an 
10 explicit request. The service in turn queries all modules present in the application as 
to whether they request any actions of the given service, executing them if so 
indicated. 

In more detail, as each new module, object, or component is loaded into the 
XIS framework, the PluglnManager 2905 on startup loads a special service called 

1 5 PluggableServiceFinder 2925, which searches for other services 29 1 5 and loads the 
services found into the PluglnManager 2920. The PluglnManager holds or keeps 
track of all services. These services are referred to as PluggableServices. As each 
pluggable service is loaded, the PluglnManager searches such service for defined 
resources and attaches these resources to the appropriate components or performs 

20 actions on resources found 2935. For example, a menu manager service might search 
for resources specifying menu entries and associated operations. A component that 
wants to add a menu entry to the global application menu bar would simply provide a 
resource of this type. In essence, as each new module is loaded* the PluglnManager 
tells the currently registered services ("PluggableServices") to look for new plug-ins. 

25 Thus, in essence the PluglnManager acts as a plug-in for plug-in handlers. 

The combination of the PluglnManager and the PluggableService interface 
allows communication between an XIS application and various XIS components. The 
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components may contain a number of resources that affect certain areas of XIS. For 
example, they may have a resource file that contains an ECMA script. ECMA is an 
international industry association dedicated to the standardization of information and 
communication systems (see www.ecma.ch). If there is a PluggableService that 

5 knows about that resource file, then it may decide to run the ECMA script when it 
finds the resource. The PluglnManager is responsible for managing the resource list 
and all PluggableServices. When a new PluggableService is added, it is given all the 
resources to determine if it is interested in any of the resources on the list. If it is 
interested in a resource, then it may perform some action. 

10 In one embodiment of the invention, an ASCII file is created to indicate that a 

JAR file contains a resource to be provided to all PluggableServices. 

Table IX below shows an exemplary ASCII file that indicates that there are 
resources associated with the module containing the Table View class. It does not 
indicate what resources exist; it is up to the PluggableServices to determine if there is 

15 a resource in which they are interested. The PluglnManager, using Class.forNameO, 
creates the Table View.class and calls the loadPlugln method on each of the 
PluggableServices. Below is the content of the loadPlugln method in the 
MimeTypesPluggableService: 



Table IX 

public static final String RESOURCEJNAME = 'leifResources/mime.types"; 
public void loadPhigIn(Class relativeClass) { 
if (loadedResources = null) { 
synchronized (this) { 
if (loadedResources = null) { 

loadedResources = new HashSetQ; 
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} 

} 

} 

try{ 

String resource = PlugInManagerxonvertResourceName( 

relativeClass > RESOURCENAME); 
ClassLoader loader = relativeClass.getClassLoaderO; 
Enumeration enum = loader.getResources(resource); 
while (enum.hasMoreElementsO) { 

URL resourceURL = (URL)enum.nextElement(); 

if (resourceURL != null) { 

if (!loadedResourcesxontains(resourceURL)) { 
loadedResources.add(resourceURL); 

LeifJAFUtilities.addMimeTypes( 

baselnfoModel.getOwnedBeanContextChildO, resourceURL); 
} 

} 

} 

} catch (lOException e) { 
e.printStackTrace(); 

} 



The entire arrangement of data sources separated from consumers by a 
mediating structure, InfoModels providing context to Views, and a ViewHost and 
5 plug in manager playing set central organizing roles, allows a multi-purpose 
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application to be rapidly assembled out of preexisting components. Each available 
data source and consumer component may be integrated into the application by the 
plug in manager, and compartmentalization. 

Figure 30 shows a flow diagram of an embodiment of the invention that assists 

5 in creating XML (extensible markup language) DSIs and database DSIs. The XIS 
framework provides two sets of facilities for exposing electronically available 
1 information that comes from data sources that are partly structured and/or self- 
describing, and for writing back possibly modified information to the sources. For 
example, one of these works for XML formatted data, and the other works for data 

10 stored in relational databases. However, the mechanisms are inherently extensible to 
any other data source that is partly structured and/or self-describing. 

The World Wide Web Consortium (W3C), which has standardized most of the 
XML formats to date, is in the process of defining a new XML format for declaring 
schemas, called XML Schema. The XML schema addresses the means for defining 

1 5 the structure, content, and semantics of XML documents . The present invention is 
configured to take into account future versions of the XML schema. 

In one embodiment, the present invention includes aspects of the method 
outlined below that are in common between the XML and relational database 
interfaces and can be applied in this general capacity to be part of the invention as 

20 well. In particular (described further below), an embodiment includes the apparatus 
involving separate processing of "data" (3002 branch) and "schema" (3004 branch) 
information, with a type conversion stage 3012 during the former and a metadata 
creation stage 3014 during the latter, followed by the construction of semantically 
enriched attributes 3016, 3018 based on the results of both these processes. 

25 In one embodiment, one method involves two apparatus or facilities designed 

to handle extensible markup language (XML) formatted data. An XML text stream 
comprises of a set of hierarchically structured "tags" interspersed with text "content". 
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The names, data types, and ordering of the tags may vary from stream to stream and is 
specified by a separate document called an "XML schema." A description of the 
XML schema is provided in the document "XML Schema Part 1: Structures (Working 
Draft)", which may be obtained from the W3C at the WWW address of 

5 http://www.w3.org/TR/xmIschema-l, and also in the document "XML Schema Part 2: 
Datatypes (Working Draft)", which may be obtained at the WWW address of 
http://www.w3.org/TR/xmlschema-2. Given an XML data stream, the first apparatus 
parses the XML schema appropriate for it and constructs metadata specifications 
appropriate for the contents of each tag. In some cases, these specifications are in the 

10 form of computer program segments that can be compiled into executable procedures 
that can be accessed immediately by a running application; in other cases, they refer 
directly to already precompiled procedures. The second apparatus parses the data 
document, matching the tags up with the types and metadata derived from the schema, 
and exposes the content in the standardized information representation using this 

15 metadata. This information includes the generic relational links described above in 
addition to attributes and metadata. 

In particular, the structures defined by an XML schema document determine 
the hierarchical and type structure allowed in XML instance documents, and this 
structure is paralleled again in the information elements (with attributes and member 

20 elements) constructed on parsing an instance. The following table (Table X) shows 
the correspondence: 
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Table X 


XML Schema 


Compliant XML 
Instance 


Resulting Information 
Element 


simple type outside attribute 
declaration 


element with no 
subelements 


(typed) attribute 


simple type inside attribute 
declaration 


attribute 


(typed) attribute 


complex type without 
descendents 


element with attributes 
but no subelements 


information element with 
attributes 


complex type with 
descendents 


element with 
subelements 


information element with 
member elements 



A complexType element, as defined in the W3C XML Schema standard, 
defines the structure of an information element Elements contained within the 
complexType element which are defined as complexTypes themselves, are translated 
into the member elements of the information element defined by the containing 
complexType. All other elements and attributes contained within the complexType 
element, and defining single value types, are translated into attributes of the 
information element defined by the containing complexType. 

The XML ingestion process supports an additional capability that allows for 
the translation of types defined by an XML Schema, into more semantically rich 
domain policy based attributes that consumers in the present framewoik can take 
advantage of. To do this an embodiment of the present invention includes a process 
that uses XSLT (XML Stylesheet Language Transformations) to scan an XSDL 
(XML Schema Definition Language) document, and embed domain specific 
instructions in a new version of the XSDL document The embedded instructions 
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direct the XML processing software to create information elements that contain the 
semantically richer domain attribute, representations. In particular, the tags in the 
table below may be placed by the XSLT within <appinfo> subelements of elements in 
the XSDL schema document. When the schema parsing apparatus reads the resulting 

5 schema, it sets up the XML processor to perform the mappings as shown when 
reading an instance document. Because of the nature of the handling specified for 
<appinfo> elements in the XSDL specification (see the W3C Web site at 
http://www.w3.org/XML/Schema), these will simply be ignored by other XML 
schema processors that have not been designed to read them. Table XI lists properties 

10 that may be used: 



Table XI 


Property 


Description 


domainfield 


A Domain Policy attribute to map instances of this XML element 
or attribute to 


typemetadata 


A metadata type to map instances of this XML element or 
attribute 


converter 


A type converter for transformation of XML data values (strings) 
into typed values such as floating point numbers or date objects 


visible 


The initial visibility state with which instances of this XML 
element or attribute should be exposed within an information 
element 


mutable 


Whether or not instances of this XML element or attribute can be 
edited after being exposed within an information element 
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Conversely, the system has the ability to construct an XML document and 
associated XML Schema from a hierarchy of information elements. The process for 
outputting an XML document and associated XML Schema from a hierarchy of 
information elements is essentially the reverse of the ingestion process. The resulting 
5 schema documents are generated with the special <appmfo> instructions that carry the 
additional semantic meaning for die attributes, but (see above) these additional 
instructions are embedded in a way that makes them transparent to other XML 
document readers that do not recognize them. In this way, an application-to- 
application information communication session can be set up using HTTP or a similar 

10 protocol for synchronous communications, and SMTP or similar for asynchronous 
communications. The sending application encodes information elements into an 
XML schema/instance pair using the just described apparatus and sends both to the 
receiver application. The receiver reconstructs the information elements also using 
the above apparatus. Thus, any form of structured, annotated information that can be 

1 5 expressed within our framework can be transmitted between applications using a 
simple document transfer protocol. Another embodiment of the present invention 
involves an apparatus 3020 , which will connect to a relational database system and 
extract or write information from it using the structured query language (SQL). The 
user of such an information source needs only to specify the tables and columns to 

20 access within the database, as well as any selection criteria to narrow the range of data 
returned. The apparatus performing this function will automatically convert the data 
in the database into the appropriate representational format and add metadata and 
parent-child links as required. In general, the process is similar to that described for 
the XML data input/output capability, except that SQL statements and conversion 

25 mappings specified by the user take the place of the XML schema and document type 
and hierarchy information. 
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The process translates the result of a database query into an XIS data item, and 
each row in the result set is translated into a member data item of the result data item. 
Each row data item can also have a database query associated with it which can be 
executed to provide its own member data item. Access to the member items is on- 

5 demand (e.g., as called for by a consumer), an operation we refer to as "drill-down". 
The row data items are created with attributes that are derived from the 
columns returned by the result set. The attribute specifications can be generated 
automatically from the result set column SQL type specifications (integer, date, text, 
etc.), or can be customized to suit the needs of the user. The customization process 

10 allows the user to map database result column type definitions into more semantically 
rich domain policy and/or metadata-enhanced attributes that consumers can take 
advantage of. In other words, the DSI can associate column data types with metadata 
types and domain policy attribute types. To do this the framework supports a number 
of attribute customization properties that the user can specify (described further 

15 below). 

Modifications to row data items are handled by allowing the user to associate 
parameterized update, insert and delete queries with a given result set When the 
value of a record member attribute is changed, the user specified parameterized query 
is executed, and the parameters are filled in from the attribute values identified in the 
20 query specification. Insertion and deletion of record members are handled in a 
likewise manner. 

The following table, Table XII, describes the list of customizable properties 
supported by the SQL database interface process. These properties are used to 
describe a single interface to a database for producing one or more hierarchically 
25 organized information elements from its contents. 
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Table XII 


Property 


Description 


jdbc.driver 


JDBC vendor driver class name 


jdbc.url 


JDBC database connection URL 


display .name 


Default display name for result data item 


select.query 


SQL select statement for result data item 


update.query 


Parameterized SQL update statement 


update.coiumns 


Result column names that fill update query parameters 


insertquery 


Parameterized SQL insert statement 


insert.columns 


Result column names that fill insert query parameters 


delete.queiy 


Parameterized SQL delete statement 


delete.cohimns 


Result column names that fill delete query parameters 


drilldown. query 


Parameterized SQL select statement for record drill- 
down 


drilldownxoiumns 


Result column names that fill drill-down query 
parameters 


resultattributes 


Result data item attribute names 


record.attributes 


Record data item attribute names 



The names of attributes listed for both result and record data items are used to 
uniquely identify the attributes. The customization of each attribute is done according 
to its unique name. The following table (Table XIII) describes the list of 
customizable properties that can be applied to each attribute, where <name> is the 
unique attribute name. Note the parallel between these properties and those given for 
the , <appinfo> f tag insertion in the case above of XML data parsing. 
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Table Xni 


Property 


Description 


<name>.label 


The attribute display label 


<name>.domainfield 


A XIS Domain Policy class field to map this attribute 
to 


<name>.typemetadata 


A XIS metadata class name to map this attribute to 


<name>.converter 


A XIS type converter for transformation of result 
values 


<name>.columns 


The result columns names that will be converted 


<name>.visible 


The attribute initial visibility state 


<name>.mutable 


The editability of the attribute 



Given the metadata from known industry standard APIs (e.g., JDBC and 
ODBC) that provide metadata for results (typically handled as tabular columns) 

5 including string, length, numeric precision, date formatting, etc, relational databases 
may have dynamic DSI toolkit built and implemented as shown in Figure 27. Tabular 
data may also be interpreted as a default string typed. Java objects, remote Java 
objects (via RMI or CORBA-derived interfaces), and Enterprise JavaBeans (a variant 
of RMI objects) may have DSIs automatically created for than, using, for example, 

10 reflection and known types (primitives and other typical types like String, Data, etc., 
and registered types). A developer may also place XlS-specific annotations (e.g., 
static AttributeDescriptor and FieldData methods) on reflected Java objects. 
Collection subclassed objects may also indicate containment. 

Dynamic data supplemental metadata may also be used in the XIS framework 

15 of the present invention. Schemas with little or no expressive information may also 
be used to specify additional metadata within the XIS framework, which include 
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mapping attributes to type metadata, mapping attributes or methods to domains, 
defining new attributes/methods based on existing data from the source, defining 
functions/user commands for easily implemented capabilities (e.g., deleting a data 
item, adding/inserting a new data item, initializing a template data item that a user can 

5 fill in before adding, etc.), and defining relationships to other data items to perform 
"drill-down" queries. Such type of schemas may be obtained, for example for Java 
Metadata API, CORBA API (on which the Java API was based), Oracle "common 
warehouse metamodel," and the like. Other formats for mapping metadata to schemas 
from other sources, or as might be defined in the future, may easily be incorporated 

10 within the framework. 

Distributed Application Capabilities 

In an embodiment, the application development framework being discussed 
offers three sets of facilities to aid in the development of distributed applications in 
which users, software application components, or both are distributed across multiple 
15 computers connected by a network. 

CORBA Exposure 

The first set of facilities allows the automatic exposure of a data source over a 
network to any remote consumer software object via the Common Object Request 
Broker Architecture (CORBA) protocol. This protocol allows the remote consumer to 
20 utilize information elements just as if they existed locally, but usually with lower 

bandwidth than it would take to send the entire elements over the network connection. 

To better understand the invention, examples are shown below in Table XIV, 
which shows an exemplary XML document. 



Table XIV • 


<tracks> 




<track name="FIRST"> 
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<country>US</country> 
<category>SUB</category> 
<threat>HOS</threat> 
<position> 

<lat>10.(Xlat> 
<lon>10.0</lon> 
<alt>10.0</alt> 
</position> 
</track> 

<track name="SECOND"> 
<country>US</country> 
<category>AIR<ycategory> 
<threat>FRI</threat> 
<positioji> 

<lat>20,0</lat> 
<lon>20,0</lon> 
<alt>20.0</alt> 
</position> 
</track> 
</tracks> 



The following table (Table XV) shows the result if the above XML document 
were run through an XML DSL 

5 

Table XV 

LEIF Data Item - tracks ——————— — ~ 
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LED 7 Data Item - track 

Attribute - name : String value= > FIRST 5 
Attribute - country : String value='US' 
Attribute - category : String value^SUB* 
Attribute - threat : String value^'HOS' 
LEIF Data Item - position : LEIF Data Item 
Attribute ~ lat : String value^lO.O' 
Attribute - Ion : String value= , 10.0 > 
Attribute - alt : String value-' 10.0' 
LEIF Data Item - track 

Attribute - name : String value='SECOND> 
Attribute - country : String value-'US* 
Attribute - category : String valued AIR/ 
Attribute - threat : String value='FRT 
LEIF Data Item - position 

Attribute - lat : String value='20.0' 
Attribute - Ion : String value='20.0 > 
Attribute - alt : String value^'20.0' 



Table XVI below shows an exemplary XSDL document. 



Table XVI 

<?xml version^LO 1 ' encoding="UTF-8"?> 
<schema xmlns- Tittp://www.w3.org/l 999/XMLSchema n > 
<element name-'tracks'^ 
<complexType> 

<element name-'track" type='Track" maxOccurs="unbounded M /> 
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</complexType> 
</element> 

<complexType name =>l Track n > 

<attribute name= ,l name ,r type- 'string7> 
<element name-'country" type- 'string7> 
<element name="category" type="string M > 
<element name="threat M type="string ,f /> 
<element name- position" type= rr LatLonAlt ,, /> 

</complexType> 

<complexType name= ,f LatLonAlt"> 
<elementname=' ! lat" type=="decimar7> 
<element name="lon" type="decimal"/> 
element name=="alt" type= fl decimal n /> 

</complexType> 
</schema> 



XML Schema Definition Language (.xsd) documents are used to express the 
semantic descriptions of Attributes and the Domains in which they live. Code 

5 generation utilities as described above create the actual Domain Objects with their 
groups of related Attributes. Thus, developers may create new Domains, and add 
Attributes to their existing Domains, by modifying these XML Schema files and 
generating the appropriate Java code. XML Schema files include basic attribute 
constraints (e.g., value ranges, list of valid values, attribute naming, formatting, etc.) 

10 that are turned into TypeMetaData objects, as well as textual comments that are 

converted into Java documentation to define the intent of the attribute (or method, in 
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the case of Domain methods). In some cases, Java code is embedded in the document 
and used inline in the generated Java classes for the Domain. 

Table XVII below shows the result when the above XSDL document is used to 
type the elements in the XML document source. Note that the type for lat, Ion, and alt 
5 are now Double instead of String. 



Table XVII 

LEE? Data Item - tracks 
LEIF Data Item - track 

Attribute - name : String value-'FIRST 
Attribute - country : String value= > US > 
Attribute - category : String value^'SUB' 
Attribute - threat : String value-'HOS' 
LEIF Data Item - position 

Attribute - lat : Double value-' 10.0 s 
Attribute - Ion : Double value-' 10.0* 
Attribute - alt : Double value-'lO.O' 
LEIF Data Item - track 

Attribute - name : String value-' SECOND' 
Attribute - country : String value-'US' 
Attribute - category : String value-' AIR' 
Attribute - threat : String value='FRI' 
LEIF Data Item - position 

Attribute ~ lat : Double value-'20.0' 
Attribute - Ion : Double value-'20.0' 
Attribute - alt : Double value='20.0' 
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The following table (Table XVTII) shows an exemplary XSLT document. 



Table XVIII 

<xsl:for-each select="xsd:element"> 
<xsl:choose> 

<xsl: when test= M @name= =, position'"> 
<xsl:copy> 

<xsl:apply-templates select="@*"/> 
<annotation> 
<appinfo> 
<domainmap 

domainfield ; = t, com-xis.doinains.geo.GeoDomain.latLonAlt H 

converter="DegreesToLatLonAltConverter" 

parameters-'la^lonjalt" 

labeI-"Position" 

/> 

</appinfo> 
</annotation> 
</xsl:copy> 
</xsl:when> 
<xsl:otherwise> 
<xsl:copy> 

<xsl:apply-templates select="@*"/> 
</xsl:copy> 
</xsl:otherwise> 
</xsl:choose> 
</xsl:for-each> 
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When such a transformation is used with the previous XSDL source shown 
above, used to type the XML document source, the result is shown in Table XDC 
below. 



Table XDC 

LEIF Data Item - tracks —————————— 

LEIF Data Item - track 

Attribute - name : String value='FIRST > 
Attribute - country : String value= , US > 
Attribute - category : String vaIue='SUB' 
Attribute - threat : String value-'HOS* 
Attribute - position : LatLonAlt <^ now mapped to 

GeoDomain.latLonAlt 
LEIF Data Item - track 

Attribute - name r attribute value^ 9 SECOND* 
Attribute - country : String value^'US' 
Attribute - category : String value=' AIR* 
Attribute - threat : String value=TRT 
Attribute - position : LatLonAlt <- now mapped to 

GeoDomain.latLonAlt 



Note that position has been mapped to GeoDomain.latLonAlt, meaning, it is 
now a LatLonAlt type. The lat, Ion, and alt attributes are still die same, but the 
position itself may now be dealt as a single LatLonAlt object rather than a generic 
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data item with three Double fields. The use of XSLT also enables the mapping of 
XML elements into TypeMetaData, such as the LatLonAltTypeMetaData in order 
have better manipulation of the data. 

In one embodiment of the invention, the XIS framework has a "remote" 
5 capability enabling referral to an XIS session, or the data within it, from a remote 
virtual machine. Primarily, this means that data retrieval and sharing is the basis for 
export and collaboration. Secondarily, it supports operating on data within XIS from 
a remote virtual machine, perhaps on information existing only at that remote virtual 
machine. 

10 In another embodiment, SOAP (Simple Object Access Protocol) may be 

utilized. SOAP is a messaging framework that defines a protocol for the exchange of 
information in a decentralized, distributed environment. See, for example, the W3C 
Web site at http://www.w3.org/TR/SOAP. SOAP provides an instantiation of the 
remote capability, and is used to enable a general-purpose means of mating together 

is or communicating among distributed sessions. These sessions may be two full XIS 
sessions on separate servers, or may comprise one XIS server and one XIS client, or 
may be used to interface XIS to otherwise very different software, even including 
software applications written in different programming languages and running on 
incompatible operating systems. All data and remote procedure calls are made 

20 through XML. Those skilled in the art will be understand that SOAP is an XML- 
based protocol. The working draft of this specification is currently being developed 
bytheW3C. 

In another embodiment, remote references are used. These references are 
persistable or persistent references to XIS data. In a distributed context XIS uses 
25 XML representations of the references to share, persist, or identify particular data. 
Embedded in the XML are custom information enabling determination of data 
location in files or databases, on web servers, or based on unique Ids or names within 
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the XIS session, or based on data which are passed to a constructor, or on an ECMA 
script that can re-generate the data object 

In another embodiment, the data representation in the remote distributed 
sessions is all based on the XIS mediation layer. All data, regardless of the initial 
5 type, is.passed and manipulated as sets of attributes and relationships. This greatly 
enhances portability and interoperability of the data. At the same time the data 
contains a global unique identifier, so the individual and specific source and identity 
of that data is maintained in spite of having been translated to a mediated format 
In another embodiment, a metadata type, e.g., "Constructor Scripts," is used. 

10 This metadata type supports the generation of ECMA Script scripts to restore a 
TypeMetaData (metadata type) object at a later time. By executing the script, the 
TypeMetaData is restored to its exact state. The advantage over standard Java object 
serialization is control over the save/restore process, and the ability to represent the 
state in fairly readable text format. 

15 Distributed Multi-user Collaboration 

Figure 31 is a schematic diagram of the second set of facilities that allows 
users at remote computers to collaborate through shared views of the same data. It 
also shows objects and methods that may be involved in distributed collaboration 
facilities. Visual consumer components (e.g., INFOBEANs) are condensed and 

20 compressed so that they may be efficiently accessed by a remote computer and then 
locally displayed. This is done using a MetaView object, which encapsulates the 
essential elements of a visual component to allow reconstruction on another screen 
with minimum requirement for data transmission. MetaViews are manipulated using 
the relationship handling machinery of the framework as discussed above; in 

25 particular, an indirect reference to the MetaView is produced and passed around to 
remote consumers, who need only resolve the reference and retrieve the MetaView 
object if the user requests the display. 
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An event-handling schema is introduced for transmission of changes in the 
view from one computer to all others that are joined to the session. View 
management is accomplished via a "tree" display showing hierarchies of local views, 
sessions, and shared views (including properties and subsidiary data items). Views 
5 may be shared through the intuitive action of dragging and dropping them from one 
branch on the tree to another. Multicast protocols may be used so that MetaViews, 
LeifReferences (references), and Event objects may be transmitted directly from one 
computer to another without the need to go through a server. Alternatively, HTTP 
protocols may be employed if security and firewall considerations make multicasting 
10 impractical. 

Metadata Server Facilities 

Figure 32 shows a third set of facilities that allows remote consumer software 
objects 3220 to obtain additional annotations on information that is encountered along 
with at least a minimal self-description component, as may be found, e.g., in an XML 

15 tag name. These facilities are targeted to be useful to software agents 3202 in 
particular. (See Wooldridge, M., Jennings, N. (1995); "Intelligent Agents: Theory 
and Practice 1 ' in Knowledge Engineering Review 10:2.) For example, a Java software 
agent may occasionally encounter data objects or request terms, which were not 
anticipated when the agent was programmed. The tag name or other descriptive 

20 annotation (connector) 3206 is used as a key to request metadata and possibly domain 
policy methods defined within XIS from a known server, called a semantic repository 
3204. The server 3204 checks its index for a match; if a match is not found, it can 
optionally ask a predicate logic inference engine 3208 to provide alternate names to 
search under (e.g., "cat, large, ferocious" is returned from the inference engine in 

25 response to a request for 'lion"), which are then also compared to the index. If a 
match is found, the server returns the appropriate metadata and possibly domain 
policy method(s) to the requesting agent 3202, making use of either Sun's Jini 
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framework or Java's built-in provisions 3222 for network transfer and subsequent 
dynamic loading of classes (including, e.g., procedural components of the metadata 
and methods) to transfer the actual code procedures into the running agent. These 
transferred information can then be used by the agent 3202 to aid in handling the 

5 object. For example, an agent can display an unanticipated data type to a user by 
calling the Tenderer method thus returned from the semantic repository. The semantic 
repository may also interface with other repositories 3212 via a data network 3210, 
such as a wide area network (W AN) 32 1 0. 

In the above embodiment, information metadata and even information access 

10 software may be dynamically downloaded from remote sources ("semantic 

repositories " or "Metadata Server Facilities"), e.g., from the data source itself or from 
an intermediary server. This is a unique feature particularly as applied to XIS 
metadata, domain policies, and DSIs. 

One skilled in the art will further understand that the common representation of 

15 and access to information from internal APIs (mediation layer) may be exported to 
distributed application in support of middleware architectures for scalability or other 
advantages, and in support of collaboration by sharing data and data changes 
(permanent or transient) with other distributed collaborators. 

The present invention also supports user "transfer" of objects from one context 

20 (e.g., between two INFOBEANs) via drag/drop, cut/paste, and other mechanisms. 
Transfers of objects apply only to non-contextual information. Thus, each view has 
its own InfoModel that provides the contextual information for that view alone. 
Example 5 below further explains this idea. 
Example 5 

25 The Example 5 application is contained in three Java source files, 

HelloWorld.java, HelloWorldTranslator.java, and TestHamess.java. The source files 
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for this Example are explained below. The resulting outputs are shown in Figures 
38A and 38B. Non-contextual information is transferred in this Example. 

The Java source files in Example 5 modify those from Example 3 or 4 to 
demonstrate the use of drag and drop facilities within XIS, along with a more 
5 complex view. As before, changes from the previous step are marked by open and 
close commented braces. 

The table below (Table XX) shows a code snippet that replaces a portion of 
code in the HelloWorldjava file shown in Example 3. The code portion below 
replaces the portion of code 2102 found in Figure 21 to implement Example 5. 



Table XX 

/*{*/ 

private String myNarae; 
public Hello World(String myName) { 
this.myName * myName; 

} 

public String toStringO { 
return myName; 

} 

/*}*/ 



With the above modification, the HelloWorldjava file for this Example has 
been enhanced so that instances can be given names upon creation, and this name is 
15 returned by the toStringQ method. Also, the getJDQ method has been removed. 
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The HelloWorldTranslator.java file for this Example is similar to the 
HelloWorldTranslator.java file shown in Figures 22A to 22C, except that this source 
file has been simplified from the previous version by removing the "course" attribute. 
Figures 37A to 37D list the TestHarness.java source file, where the bulk of the 

5 changes are coded* First of all, it contains an import to help lay out multiple 

components within a Jframe 3702, and also imports for two new XIS INFOBEANs: a 
Table bean and a Tree bean 3704. The tree bean displays data items and any member 
data items they contain, and enables users to select and perform various functions on 
1 them such as editing their properties. The table bean displays the attributes of 

10 multiple data items in a user-configurable way. 

The first portion of new code 3706A and 3706B initializes several HelloWorld 
objects and inserts them into an array. The table and plot INFOBEANs are initialized 
and placed side-by-side in a JFrame. They are not loaded with any data items, but 
items can be dragged onto them when the application is running. The next thing is 

15 that a tree ESFFOBEAN is initialized and loaded with the array, and it is put up in its 
own JFrame. 

This Example 5 application puts up two windows— the first is a Tree 
INFOBEAN containing several HelloWorld data items. The second has two frames, 
on the left a Table INFOBEAN, on the right a Chart INFOBEAN, both of which are 

20 initially empty. The table is initially completely blank because it has no information 
on what headings are appropriate, while the plot displays a default grid. 

In the tree display, a user may select data items or open and close them, similar 
to the directory tree view provided by the "Windows Explorer" application. In this 
case, the only item that contains anything is the root, which is a special data item. 

25 Double-clicking on it opens or closes it, but it cannot itself be selected. Right clicking 
on an item (but not the root) brings up a menu of operations that may be performed on 
it In particular, selecting 'Properties 1 brings up a property sheet.window (as in the 
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previous examples) for that particular instance. A user may left-click-and-drag on 
data items from the property sheet window over to the table or the plot. 

The table automatically sets up columns for the preferred attributes of the data 
items dragged onto it. The layout may be changed interactively by either dragging on 

5 the headings or their boundaries, or by right clicking on the headings. Double 

clicking on the attributes enables a user to edit them. Items may also be dragged from 
the table onto the plot as well, or in the other direction. The selection and pen color 
attributes are kept aligned automatically between all views of the same data item. A 
user exits the application by closing the tree window. 

10 Data item commands, also known as JAF Commands (based on "JavaBeans 

Activation Framework 1 ') may also be implemented within XIS. The JAF API is a part 
of Java and provides a way to associate commands with object. By using JAF, 
developers may take advantage of standard Java interfaces to determine the type of an 
artitrary piece of data, encapsulate access to it, discover the operations available for it, 

15 and to instantiate the appropriate bean to perform said operations). For example, if a 
browser obtained a JPEG image, JAF would enable the browser to identify that the 
stream of data is a JPEG image, and from that type, the browser could locate and 
instantiate an object that could manipulate, or view that image. JAF commands are 
typically used in pop-up menus or menu bars to control objects. 

20 XIS uses JAF commands to control DSIs and perform operation on data items. 

Right clicking on a data item in an InfoBean pops up a menu with commands that are 
specific to that data item. JAF commands with XIS may implement the following: 

- "Context Menus" or pop-up menus initiated by right clicking on a 
25 display that represents one (or more) data items; 
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- Command "menus" may be combined into a menu for multiple objects 

(e.g., one single command (menu item) to delete all selected 
objects; 

- Addition of data item commands per object type by adding them to the 

"JAF" registry; 

- Addition of file/content MIME types in the display; 

- Addition to the "JAF" registry of entries that represent objects that can 

add any number of menu items dynamically; 

- JAF commands may be added by "Menu Populators" that can add 

menu items for single and multiple data items; 

- JAF commands may be added by the environment for other typical 

functions that might be performed on any object (possibly 
depending on capabilities/content of that data item), e.g., 
Copy/Paste/Cut/Delete, Hide/Show, Refers To (if the object 
exposed relationships to other objects which may or may not be 
loaded yet), Contains, Referred by, Contained by, URLs 
(attributes), Properties, etc.; and 

- Default behavior of "Properties" command may be overridden using a 

"JAF entry." 

Figures 38A, 38B, 38C, and 38D show how JAF is used within the framework. 
Figure 38 A shows a menu of HelloWorld objects for selection, displayed on a screen 
of the computer system implementing the framework. Figure 38B shows that the 
HelloWorld objects are displayed through a graphing (data plot) viewer. Figure 38C 
shows the display of Figure 38B after the display cursor has been positioned over the 
bar graph, followed by a right-click. A context menu, enabling the user to select the 
"Properties" option, is displayed in Figure 38D. In this example, the HelloWorld 
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object can be manipulated by a PropertySheetlnfoBean object Thus, selecting the 
"Properties" option results in a PropertySheetlnfoBean being instantiated showing the 
properties of the First HelloWorld object, as shown in Figure 38D. 

Another feature provided by the XIS framework is the use of attribute aliases. 

5 This enables one attribute from one domain to be substituted for an attribute in 
another domain. For illustration purposes, let us assume that we have two domains 
called Movement Domain and Physics Domain. The attribute speed in knots is 
defined in the Movement Domain, while the attribute velocity in meters/sec is defined 
in the Physics Domain. The XIS framework enables a developer to register or define 

1 o that the speed attribute in the Movement Domain is similar or compatible with the 
velocity attribute in the Physics Domain. Thus, enabling a data consumer object to 
ask for the Attribute from the domain that it knows about, and have the value 
translated from the Attribute of the DSI from the second domain. 

Figure 39A, 39B, and 39C show details of an exemplary embodiment 

15 explaining how an interface for the attribute alias feature described above may be 
defined or implemented within the XIS framework. The illustration includes class 
listing for objects that are used in the preferred embodiment of the framework. 

Figure 40 is a block diagram of a computer that may be used to implement the 
framework described herein. The framework may be used in a single computer, or 

20 may be used in conjunction with one or more computers that may communicate with 
each other over a network to share data. Those skilled in the art will appreciate that 
the various data objects, framework extensions, and other processes described above 
may be implemented with one or more computers, all of which may have a similar 
computer construction to that illstrated in Figure 40, or may have alternative 

25 constructions consistent with the capabilities described herein. 

Figure 40 shows an exemplary computer 4000 such as might comprise a 
computer in which an object oriented programming environment is supported to 
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permit the framework operations described above, and to permit the various display 
operations and computer processing events. Each computer 4000 operates under 
control of a central processor unit (CPU) 4002, such as a "Pentium" microprocessor 
and associated integrated circuit chips, available from Intel Corporation of Santa 
Clara, California, USA. A computer user can input commands and data from a 
keyboard and computer mouse 4004, and can view inputs and computer output at a 
display 4006. The display is typically a video monitor or flat panel display. The 
computer 4000 also includes a direct access storage device (DASD) 4008, such as a 
hard disk drive. The memory 4010 typically comprises volatile semiconductor 
random access memory (RAM). Each computer preferably includes a program 
product reader 4012 that accepts a program product storage device 4014, from which 
the program product reader can read data (and to which it can optionally write data). 
The program product reader can comprise, for example, a disk drive, and the program 
product storage device can comprise removable storage media such as a magnetic 
floppy disk, a CD-R disc, a CD-RW disc, or DVD disc. 

The computer 4000 can communicate with other computers over a computer 
network 4016 (such as the Internet or an intranet) through a network interface 4018 
that enables communication over a connection 4020 between the network 4016 and 
the computer 4000. The network interface 4018 typically comprises, for example, a 
Network Interface Card (NIC) or a modem that permits communications over a 
variety of networks. 

The CPU 4002 operates under control of programming steps that are 
temporarily stored in the memory 4010 of the computer 4000. When the 
programming steps are executed, the computer performs its functions. Thus, the 
programming steps implement the functionality of the event tracking process 
described above. The programming steps can be received from the DASD 4008, 
through the program product storage device 4014, or through the network connection 
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4020. The program product storage drive 4012 can receive a program product 4014, 
read programming steps recorded thereon, and transfer the programming steps into the 
memory 4010 for execution by the CPU 4002. As noted above, the program product 
storage device can comprise any one of multiple removable media having recorded 
computer-readable instructions, including magnetic floppy disks and CD-ROM 
storage discs. Other suitable program product storage devices can include magnetic 
tape and semiconductor memory chips. In this way, the processing steps necessary 
for operation in accordance with the invention can be embodied on a program 
product. 

Alternatively, the program steps can be received into the operating memory 
4010 over the network 4016. In the network method, the computer receives data 
including program steps into the memory 4010 through the network interface 4018 
after network communication has been established over the network connection 4020 
by well-known methods that will be understood by those skilled in the art without 
further explanation. The program steps are then executed by the CPU 4002 thereby 
comprising a computer process. 

It should be understood that the any device that supports the framework 
envirnonment described above, acting as a host computer, will typically have a 
construction similar to that shown in Figure 40, so that details described with respect 
to the Figure 40 computer 4000 will be understood to apply to all computers of any 
network system in which the framework or framework-developed applications are 
utilized Alternatively, the devices can have an alternative construction, so long as the 
computer can communicate with the other computers and can support the 
functionality described herein. 

All patents, patent applications, publications and references mentioned in the 
specification are indicative of the practice level of those skilled in the art to which the 
invention pertains. All patents, patent applications, publications and references are 
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herein incorporated by reference to the same extent as if each individual patent, patent 
application, publication or reference was specifically and individually indicated to be 
incorporated by reference. 

One skilled in the art should readily appreciate that the present invention is 

5 well adapted to carry out the objects and obtain the ends and advantages mentioned, 
as well as those inherent therein. The specific embodiments described herein as 
presently representative, of preferred embodiments are exemplary and are not intended 
as limitations on the scope of the invention. Changes therein and other uses will 
occur to those skilled in the art which are encompassed within the spirit of the 

10 invention are defined by the scope of the claims. It will be readily apparent to one 
skilled in the art that modifications may be made to the invention disclosed herein 
without departing from the scope and spirit of the invention. 

The present invention has been described above in terms of presently preferred 
embodiments so that an understanding of the present invention can be conveyed. 

15 There are, however, many configurations for information system frameworks not 
specifically described herein but with which the present invention is applicable. The 
present invention should therefore not be seen as limited to the particular 
embodiments described herein, but rather, it should be understood that the present 
invention has wide applicability with respect to information systems generally. All 

20 modifications, variations, or equivalent arrangements and implementations that are 
within the scope of the attached claims should therefore be considered within the 
scope of the invention. 
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CLAIMS 

We claim: 

5 

1 . An extensible framework for use in a computer system that supports an 
object oriented programming environment and includes a memory in which data 
objects can be stored, the framework comprising a set of object classes that can be 
extended using object oriented principles to define an information handling 

10 application with data objects comprising a class of data source objects and a class of 
data consumer objects, and a mediation layer that defines an interface between the 
data source objects and the data consumer objects to permit data communications 
between the two data object classes, such that the class configuration of the data 
source objects can be specified independently of the class configuration of the data 

15 consumer objects. 

2. A computer system that supports an object oriented programming 
environment and includes access to data storage containing specifications for a set of 
object classes that can be extended using object oriented principles to define an 

20 information handling application with data objects comprising a class of data source 
objects and a class of data consumer objects, and a mediation layer that defines an 
interface between the data source objects and the data consumer objects to permit data 
information exchange between the two data object classes, such that the class 
configuration of the data source objects can be specified independently of the class 

25 configuration of the data consumer objects. 
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• 3. A computer system as defined in claim 2, wherein the mediation layer 
defines a data interface that provides an information exchange standard between the 
data source objects and the data consumer objects. 

5 4. A computer system as defined in claim 3, wherein the data interface 

includes at least one attribute/metadata object class that specifies attributes, including 
metadata, and that provide declarative and procedural information relating to 
attributes in said data object. 

ID 5. A computer system as defined in claim 3, wherein the data interface 

includes at least one Relationship object class that specifies relationships between 
data source class objects. 

6. A computer system as defined in claim 3, wherein the data interface 
15 includes at least one Domain Policy object class that specifies a group of related 

attributes, methods, and semantic information that indicates data processing to be 
available for the specified attributes, including the specific intent of said attributes. 

7. A computer system as defined in claim 3, wherein the data interface 
20 includes at least one Event Change object class that specifies change event 

registration for detecting changes in the data objects. 

8. A computer system as defined in claim 4, further including a 
TypeMetaData class of objects that specify semantic information indicating data 

25 processing to be available for specified attributes and intended use of the attributes of 
a data object. 
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9. A computer system as defined in claim 8, further including a TypelO 
class of objects that define a desired format of a data object attribute specified by a 
TypeMetaData class. 

5 10. A computer system as defined in claim 6, wherein an attribute alias may 

be specified by a user to indicate any data source attributes of an attribute domain that 
may be substituted with attributes of a different attribute domain. 

11. A computer system as defined in claim 4, wherein said 

10 attribute/metadata interface provides input/output functions for display and editing of 
the attribute during runtime. 

12. A computer system as defined in claim 4, further including a 
FieldMetaData attribute that specifies processing criteria for an attribute of a data 

15 object 

13. A computer system as defined in claim 4, wherein the processing 
criteria relates to a selected attribute of the data object for display processing. 

20 14. A computer system as defined in claim 5, wherein the indicated 

relationship may be resolved using a version of the Relationship object in cache of the 
computer system. 

15. A computer system as defined in claim 2, further including a 
25 collaboration facility that permits a user at a network computer remote from the 
computer system to share a view of a data object at the remote network computer. 
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16. A computer system as defined in claim 15, wherein the collaboration 
facility comprises a MetaView class of data objects that lightweight encapsulate 
elements of a data object for visual reconstruction on a display screen of the remote 
network computer. 

5 

17. A computer system as defined in claim 4, wherein the data interface 
provides an override function that can override default metadata of the data object 
attributes. 

io 18. A computer system as defined in claim 6, wherein the data interface 

provides an override function that can override default metadata of the data object 
attributes. 



19. A computer system as defined in claim 3, wherein data objects provided 
15 through the data interface comprise information that specifies data attributes, 

relationships, event broadcasting of changes in all registered data consumer objects, 
metadata for attributes that provide declarative and procedural information and/or 
input/output functions for display and editing, and related data items, and wherein the 
data objects can store references without direct access to a related data item. 

20 

20. A computer system as defined in claim 19, wherein the attributes and 
relationships include contextual metadata, and the events and methods are defined 
with respect to the contextual metadata, 

25 21. A computer system as defined in claim 3, wherein the mediation layer 

further includes object classes that include one or more methods that provide data 
exposure, and further including a Data Source Interface object class of data objects 
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with methods that automatically determine which data exposure method will be used 
for data communications between the data source objects and data consumer objects. 

22. A computer system as defined in claim 21 , wherein the determined data 
exposure method comprises data object reflection and introspection. 

23 . A computer system as defined in claim 2 1 , wherein the data exposure 
methods include a data source object method that provides a standard interface, a data 
source object and a Translator object that maps an alternate data interface to the 
standard interface, and a data source object that is inspected by the computer system 
to determine available data fields which are thereby exposed to data consumer objects 
by the standard interface. 

24. A computer system as defined in claim 3, wherein the data interface of 
the mediation layer provides a wrapper for the data objects. 

25. A computer system as defined in claim 24, wherein data exchange 
occurs without providing contextual data characteristics to a receiving data object. 

26. A computer system as defined in claim 25, wherein the contextual data 
characteristics are supplied by fee data object wrapper. 

27. A computer system as defined in claim 3, wherein data exchange occurs 
without providing contextual data characteristics to a receiving data object. 

28. A computer system as defined in claim 2, further including a plug-in 
manager object class that integrates service components into the application. 
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29. A computer system as defined in claim 28, wherein data service 
components interact with other components of the application to determine if a 
service is required and to determine parameters that are to be interchanged, 

5 

30. A computer system as defined in claim 29, wherein the service 
determination occurs upon introduction of newly loaded components. 

31. A computer system as defined in claim 3, further including a translator 
10 facility that translates information concerning a data object into (1) attributes and 

metadata that define groups of data source and data consumer class attributes and (2) 
an object class that specifies at least one domain method for defining groups of data 
object attributes. 

15 32. A computer system as defined in claim 24, further including an 

InfoModel data obj ect class. 

33. A computer system as defined in claim 27, wherein said contextual data 
characteristics are supplied by an InfoModel object. 

20 ■ 

34. A computer system as defined in claim 33, wherein the InfoModel 
object receives a data source object for exposure to the data consumer objects, selects 
available attributes and methods of the received data source object for data 
characterization, and determines if the addition of attributes or methods to the data 

25 source object are appropriate. 
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35. A computer system as defined in claim 6, wherein the domain is defined 
using XML schema. 

36. A method of communicating data in a computer system that supports an 
5 object oriented programming environment and includes data storage or access to data 

storage containing data objects and specifications for a set of object classes that can 
be extended using object oriented principles to define an information handling 
application, the method comprising: 

receiving one or more data objects comprising a class of data source objects; 
10 . representing the data source objects in accordance with an Information Model 

class of objects of a mediation layer that defines a data interface between the data 
. source objects and a class of data consumer objects; 

wherein the Information Model objects include methods that permit data 
communications or information exchange between the two data object classes, such 
15 that the class configuration of the data source objects can be specified independently 
of the class configuration of the data consumer objec ts. 

37. A method as defined in claim 36, further including specifying at least 
one attribute/metadata object class that specifies attributes, including metadata, and 

20 that provides declarative and procedural information relating to attributes in said data 
object. 

38 A method as defined in claim 36, further including specifying a 
Relationship object class or classes that specify relationships between data source 
25 objects. 
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39. A method as defined in claim 36, further including specifying a Domain 
Policy or Domain object class or classes that specify a group of related attributes, 
methods, and semantic information that indicates data processing to be available for 
the specified attributes, including the specific intent of said attributes. 

5 

40. A method as defined in claim 36, further including specifying an Event 
Change object class or classes that specify change event registration for detecting 
changes in the data objects. 

10 41 . A method as defined in claim 37, further including specifying a 

TypeMetaData class of objects that specify semantic information indicating data 
processing to be available for specified attributes and intended use of the attributes of 
a data object. 

15 42. A method as defined in claim 41, further including specifying a TypelO 

class of objects that define a desired format of a data object attribute specified by a 
TypeMetaData class. 

43. A method as defined in claim 39, further including specifying an 

20 attribute alias by a user to indicate any data source attributes of an attribute domain 
that may be subtitued with attributes of a different attribute domain. 

44. A method as defined in claim 37, wherein the attribute/metadata 
interface provides input/output functions for display and editing of the attribute during 

25 runtime. 
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45. A method as defined in claim 37, wherein the attribute/metadata object 
class is a FieldMetaData attribute that specifies processing criteria for an attribute of a 
data object. 

46. A method as defined in claim 37, wherein the processing criteria relates 
to a selected attribute of the data object for display processing. 

47. A method as defined in claim 38, wherein the indicated relationship 
may be resolved using a version of the Relationship object in cache of the computer 
system. 

48. A method as defined in claim 36, further including providing a 
collaboration facility that permits a user at a nework computer remote from the 
computer system to share a view of a data object at the remote network computer. 

49. A method as defined in claim 48, wherein the collaboration facility 
comprises a MetaView class of data objects that lightweight encapsulate elements of a 
data object for visual reconstruction on a display screen of the remote network 
computer. 

50. A method as defined in claim 37, wherein the data interface provides an 
override function that can override default metadata of the data object attributes. 

51. A method as defined in claim 39, wherein the data interface provides an 
override function that can override default metadata of the data object attributes. 
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52 . A method as defined in claim 36, wherein data ohj ects provided through 
the data interface comprise information that specifies data attributes, relationships, 
event broadcasting of changes in all registered data consumer objects, metadata for 
attributes that provide declarative and procedural information and/or input/output 

5 Amotions for display and editing, and related data items, and wherein the data objects 
can store references without direct access to a related data item. 

53. A method as defined in claim 52, wherein the attributes and 
relationships include contextual metadata, and the events and methods are defined 

1 0 with respect to the contextual metadata. 

54. A method as defined in claim 36, wherein the mediation layer further 
includes object classes that include one or more methods that provide data exposure, 
and further including a Data Source Interface object class of data objects with 

15 methods that automatically determine which data exposure method will be used for 
data communications between the data source objects and data consumer objects. 

55. A method as defined in claim 54, wherein the determined data exposure 
method comprises data object reflection and introspection. 

20 

56. A method as defined in claim 54, wherein the data exposure methods 
include a data source object method that provides a standard interface, a data source 
object and a Translator object that maps an alternate data interface to the standard 
interface, and a data source object that is inspected by the computer system to 

25 determine available data fields which are thereby exposed to data consumer objects by 
the standard interface. 
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57. A method as defined in claim 36, wherein the data interface of the 
mediation layer provides a wrapper for the data objects. 

58. A method as defined in claim 57, wherein data exchange occurs without 
5 providing contextual data characteristics to a receiving data object 

59. A method as defined in claim 58, wherein the contextual data 
characteristics are supplied by the data object wrapper. 

10 60. A method as defined in claim 36, wherein data exchange occurs without 

providing contextual data characteristics to a receiving data object 

61 . A method as defined in claim 36, further including a plug-in manager 
object class that integrates service components into the application. 

15 • 

62. A method as defined in claim 61, wherein data service components 
interact with other components of the application to determine if a service is required 
and to determine parameters that are to be interchanged. 

20 63 . A method as defined in claim 62, wherein the sendee determination 

occurs upon introduction of newly loaded components. 

64. A method as defined in claim 36 , further including a translator facility 
that translates information concerning a data object into (1) attributes and metadata 
25 that define groups of data source and data consumer class attributes and (2) an object 
class that specifies at least one domain method for defining groups of data object 
attributes. 
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65. A method as defined in claim 57, further including an InfoModel data 
object class. 

5 66. A method as defined in claim 60, wherein said contextual data 

characteristics are supplied by an InfoModel object. 

67. A method as defined in claim 66, wherein the InfoModel object receives 
a data source object for exposure to the data consumer objects, selects available 

10 attributes and methods of the received data source object for data characterization, 
and determines if the addition of attributes or methods to the data source object are 
appropriate. 

68. A method as defined in claim 39, wherein the domain is defined using 
15 XML schema, 

69. A computer system that supports an object oriented programming 
environment, the system comprising: 

'a processor that executes program instructions to provide the object oriented 
20 programming environment; and 

data store means for providing program instructions containing specifications 
for a set of object classes that can be extended vising object oriented principles to 
define an information handling application with data objects comprising a class of 
data source objects and a class of data consumer objects, and a mediation layer that 
25 defines an interface between the data source objects and the data consumer objects to 
permit data information exchange between the two data object classes, such that the 
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class configuration of the data source objects can be specified independently of the 
class configuration of the data consumer objects. 

70. A computer system as defined in claim 69, wherein the mediation layer 
5 defines a data interface that provides an information exchange standard between the 

data source objects and the data consumer objects. 

71. A computer system as defined in claim 70, wherein the data interface 
includes at least one attribute/metadata object class that specifies attributes, including 

jo metadata, and that provide declarative and procedural information relating to 
attributes in said data object. 

72. A computer system as defined in claim 70, wherein the data interface 
includes at least one Relationship object class that specifies relationships between 

15 data source class objects. 

73. A computer system as defined in claim 70, wherein the data interface 
includes at least one Domain Policy object class that specifies a group of related 
attributes, methods, and semantic information that indicates data processing to be 

20 available for the specified attributes, including the specific intent of said attributes. 

74. A computer system as defined in claim 70, wherein the data interface 
includes at least one Event Change object class that specifies change event 
registration for detecting changes in the data objects. 

25 

75. A program product for use in a computer system that executes program 
instructions recorded in a computer-readable media to perform a method for 
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information exchange in a computer system that supports an object oriented 
programming environment and includes access to data storage containing data 
objects, the program product comprising: 

a recordable media; and 
5 a program product of computer-readable instructions executable by the 

computer system to perform a method comprising: 

receiving data specifications for a set of object classes that can be extended 
using object oriented principles to define an information handling application, 
wherein the extended objects provide an information handling application that can 
10 receive one or more data objects comprising a class of data source objects, and 
represent the data source objects in accordance with an Information Model class of 
objects of a mediation layer that defines a data interface between the data source 
objects and a class of data consumer objects; 

wherein the Information Model objects include methods that permit data 
is communications or information exchange between the two data object classes, such 
that the class configuration of the data source objects can be specified independently 
of the class configuration of the data consumer objects. 

76. A program product as defined in claim 75, wherein the method further 
20 includes specifying at least one attribute/metadata object class that specifies attributes, 
including metadata, and that provides declarative and procedural information relating 
to attributes in said data object. 



77. A program product as defined in claim 75, wherein the method further 
25 includes specifying a Relationship object class or classes that specify relationships 
between data source objects. 
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78. A program product as defined in claim 75, wherein the method further 
includes specifying a Domain Policy or Domain object class or classes that specify a 
group of related attributes, methods, and semantic information that indicates data 
processing to be available for the specified attributes, including the specific intent of 

5 said attributes. 

79. A program product as defined in claim 75, further including specifying 
an Event Change object class or classes that specify change event registration for 
detecting changes in the data objects. 

10 

80. A method of operating a computer system to execute an information 
handling application in an object oriented programming environment and to receive 
data from a class of data source objects and provide a class of data consumer objects 
with data, the method comprising: 

is selecting available attributes and methods of a data source object for 

characterization; 

determining attributes or methods to be added to the data source object during 
application execution; and 

receiving the data source object and determining whether to expose or hide 
20 available attributes and methods of the object from data consumer objects, wherein 
data communications between the two data object classes is supported, such that the 
class configuration of the data source objects can be specified independently of the 
class configuration of the data consumer objects. 
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Figure 2 
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Figure 6A 
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Figure 6B 
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Figure 6C 
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Figure 6E 
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Package com.xis.types 

This package contains classes thai provide several standard TypeMetaData classes for describing types and their 
constraints, and for rendering and editing values of those types. 



See: . 

D escription 



Interface Summary 


Qatajesf 


The DataTest interface specifies methods for Object validation. 




This interface defines the 10 for HTML. 


Summary Function 


The Summary Function* interface defines generic summary functionality based upon provided 
input data values. 


SvjnzTyperp 


The SwingTypalO interface allows for the use of both swing editors, allowing swing 
components to edit an object and swing renderers, which know how to render these objects in 
a swing environment. . 


TexfTypefO 


The TextTypelO interface provides a means of formatting objects in a textual fashion, as well 
as parsing- text from which an object is created. 


TvpzdValue 


The Typedvalue interface is used to hold an object that carries its own TypeMetaData with 

1U 




The TypeEditor interface defines methods for editing attributes provided by the types 
implemented within this package. 




The TypelO interface provides a common base from which other TypelOs can extend, such as 
HTMLTypelO* SwingTypelb, etc. 


TypeMetaDuta 


The TypeMetaData interface defines generic type accessors for object comparing, editing, 
formatting,. rendering, and validation. - 




The TypeMetaDataFactory interface defines a class that can, create TypeMetaData for a . 
given Class Type. 1 


Typefanderer 


The TypeRenderac interface defines methods far rendering attributes provided by the types 
implemented within this package. 


VatidTestPrnxv 


The VaiidTestProxy interface 


WMLTvpeEdUor 


The WMLTypeEditor interface defines methods for rendering attributes provided by the types 
implemented within this package. 


WMLTypelO 


This interface defines the 10 for WML format 


WMLType&mdszer 


The WMLTypeRendecer interface defines methods for rendering attributes provided by the 
types implemented within this package. 




The XMLTypeio interface provides a means of formatting objects in a XML texpaal fashion, as 
well as parsing XML text for creating an object 



\r V&. 12 A 



WO 02/46916 



16/90 



PCT/US01/48418 



Class Summary 


AbstractDataTest 


The AbstractDataTest class provides a default implementation of test 
(Object) 


AbstracJJjpeMetaQaia 


AbstractTypeMetaData provides a partial implementation of 
TypeMetaData to relieve the XIS developer from explicitly implementing 
irrelevant methods. 


OH^n perta in tyT^BClVLetADa^ 


AceaOfUncertaintyTypeMataOata is a rype object that supports 

A ya**/~i/7 fnrprt rtinPJ nhieCtS 


ArravListTvpeMetaDara 


ArrayListTypeMetaData is a type object that supports 

imtn ntil Arrmjf it! fthlftCtS 


ArravTvpeMetaDota 


ArcayTypeMetaOata is a type object that supports javaJang.reflecUrray 
objects. 


BeanTvoeM eta Data 


BeanTypeMetaOata is a type object that supports jav&beans objects. 


£0QleanTypeMe.toJBaia 


The BooIeanTypeMetaData is a type object that supports Boolean objects. 


BoolcanTvp^ M etaDataFactorv 


A BooleanTypeMetaData Factory can create a 
BooleanTypeMetaData forgiven booleans. 


CarhedTYpefrtetaPata 


CachedTypeMetaData is a type object that simply delegates all . 
TypeMetaData calls to another TypeMetaData. 


Class! ficationTypeM etADja.ta 


Claasif icationTypeMetaOata is a type object that supports 
Classification objects. 


ColtectmnsTvpcMetaData 


CollectiofisTypeMetaDaca is a type object that supports Collection 


TnlprTvpeMetaDatq ' 


The ColorTypeMetaData class implements TypeMetaData for Color 
ohiects ' 


qotprTvpeMetaDataFacjoxa: 


A CoiorTypeMetaDataFactory can create a ColocTypeMecaData for 
n oi\/f»rt Pnlnr ohtect 


(>nver$iortNumericTyp e M e * aData 


A generic NumericTypeMetaDaU for converting from one unit to another. 


£y cr^noyTy jjejVLeta^ata 


CurrencyTypeMetaData is a type object that supports Number objects 
thar renresent Currency values. 


J£aj£ilmeTy_peM^ 


OateTimeTypeMetaData is a type object that supports Date objects. 


fi n ^TjmpTy P f.jV^i9 Data Factory 


A DateTimeTypeMetaDataFactory can create a 
r\^*. B <p< na TuneMa^a r>af a for »iven Date objects. 


DiscreteRanee5.tjinR^ 


DiscreteRangeStringTypeMetaOata is a type object that supports 
String objects with discrete ranges. 


DisplavLab^HyP pMetaL?ata 


DispiayUbeiTypeMetaData is a type object that supports supports 
Display Label objects. ' 




OTGTypeMetaData is a type object that supports Date objects. 


EnumerationTyoe 


Class to implement an enumeration in Java. 


EnumeratlonTvoeMeta^ata 


The EnumerationTypeMetaData class is used to represent integer 
constants as strings to the user. 


FontTypeMetaData 


FontTypeMetaData is a type object that supports Font objects. 


^«<hMn r T Y pi»M^aData 


HashMapTypeMetaDaca is a type object that supports java.util.Hash Map 
objects. 
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HashSetTvDeMetaData 


HashSecTypeMetaData is a type object that supports java.uiU.HashSet 
objects. 


IcQjShaoeTypeMetaData 


IconShapeTypeMe^aDaca is a type object that supports IconShape 
objects. 


lconTY.pejVle.ia Data 


IconTvDeMe taDa ta is a tvne obiect that sunoorts irnn nrvprt* 


^inkedi-istTxpe^cta Daja 


Lir.kedListTypeMetaOaca is a type object that supports 
java.util.LinkedList objects. 


WistlypejyiclAPata 


ListtypeMacaData is a type object that supports jgya.utiiLisi objects. 


Mau«MapZCft?X 


The KouseMap Proxy class allows Type Editors access to the map without 
requiring them to having any compile time knowledge of the map's, 
existence. 


flu m be rCom para tor 


An implementation of the Comparator interface that compares two objects 
that extend Number, or that both implement Comparable, with the class of 

uuc ojjijy mi/io iiuiii uic uuicr. 


NumericTvpeMetaData 


NumericTypeMetaOata 1 is a type object that supports Number objects. 


jVumericTy.peMetaDataJa.Qtpry 


A NuxnericTypeMataOata Factory can create NumericTypewstaDaca 
for a given class type or method return type. 


DJyjLcjTxp^eiaJ^ata 


ObjectTypeMetaData is a type that supports a simple Object and is 
provided to quickly add arbitrary attribute types to a Data Source Interface 
without writing a mere specific type handler. 


PercentTvnerVt eta Data 


PercenCTypeMetaOata is a type object that supports Number objects that 
represent Percent<%) values. 


Prnhth!t!lvTvni>l\/tafa Pinti 

rrqqaoiiuYjjmemexaugva 


ProbabilityTypeMecaData is a type object that supports Number 
objects that represent Probability values. 


BejLam4IXJ?^eJaJData 


RenamedTypeMetaOata simply delegates all TypeMetaData calls to 
another TypeMetaData except for the getNameQ, which is overridden with 
the given value. 


Re?J«j01ejcn , 3fBeMeta J Ba^ 


ResizedTextTypeMetaData simply delegates all TypeMetaData calls to 
another TypeMetaData except for the getPixelWidihQ % which is overridden 
with the given value. 


Resources 


The Resources class is automatically generated and must be public, but it 
15 uiienucu iu uc useu oniy ay Java s iniernaiiunaii^uon support classes. 


SmartDu rationTypeM eta Data 


A SmartDurationTypeMetaData for converting from one time unit to 
anouicr Daseu on tne magnituae 01 ine □uration vaiue. 


atnngxypelviejaData . 


S tr imyTypeMetaDaca is a type object that supports String objects* 


StringTypeMetaDataFactory 


A StringTypeMetaDataFactory can.create a StringTypeMetaData 
ror a given otnng oojecu 


TextTvpeM eta Data 


TextTypeMetaData is a type object that supports Text objects. 




TypedVaiueTypeMetaOata is a type object that supports supports 
TypedValue objects. 




The TypeSditorBeanContextChildSupport class handles most of the 

1 CapUIu lUl llllwo vl b J YUCCUIlur a(iQ a QC***IV»»tlIJlC*\l^llliU. 


TvDeEditorSuDport 


The TypeEditarSuppott class handles most of the responsibilities of a 
TypeEditor. 


TypelOPIuggableService 


The TypetOPiuggableService class is responsible for loading TypelQs. 


IypefORegistry 


The TypelORegistry class is a registry for different implementations of 
TypelO classes. 
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TvpelOSuDDOrt 


The TypelOSupport provides support Tor TypeMetaData'* getTypelO 
methods. 


IvpeMelaDataJDekgaisr 


TypeMetaDataOelegatoc is a type object that simply delegates all 
TvoeMetaData calls to another TypeMetaData. 


TvDeM eta Da ta factory Plugeabie^ervicg 


The TypeMetaOataFactocyeLuggableSetvics class is responsible for 
loauing LypeivietaiJaLarauujrici. 


TvpeMetaDataFnctorvStore 


This Class stores TypeMetaDataFactories. 


^preferences 


This class is used by TypeMetaData instances to pass information about 
preferred TypeMetaData objects. 




The Types class is a holder class for the RESOURCES global variable for 
resource properties of the com jcis.rypes package. 


IJB.LTvpelVUtaQaUi 


URLTypeMe taOata is a type object mat supports URL objects. 



Exception Summary 


f 


NoSuchEnurnerattonExceotion 


Class to implement an enumeration exception in Java. 




A ParseFaUedException is thrown (typically by TypelO objects) when U is not 
possible to parse a given String as desired. 


TestFailedException 


The TestFailedException is thrown the "testQ" method of a DataTest 
subclass when the value fails the test. 



Package com.xis.types Description 

This package contains daises that "provide several standard TypeMetaData classes for describing types 
constraints, and for rendering and editing values of those types. 
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Figure 14 
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Figure 15 

HelloWorld.java 

1* XIS Tutorial standalone sequence example 1 data class. */ 

public class HelloWorld { 
' private float value = 1 .5f; 

public String toString() { 
return "Hello World!"; 

} 

public intgetlD(){ 
return 5; 

} 

public float getValueO { 
return value; 

} • • . 

// uncomment this to make "value" editable 

r 

public void setValue(float value) { 
this.value = value; 

} 

•/ ' 

} 
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Figure 16A 



1602 



TestHarness.java 

r XIS Tutorial standalone sequence example 1 XIS interfacing. */ 
import javax.swing JFrame; 
import java.awtevent.WindowAdapter; 
import java.awteventWindowEvent; 
import com.xis.propertysheetPropertySheetlnfoBean; 
import com.xis.uLUIBeanEvent; 
import com.xis.uLUIBeanAdapter; 
import com.xis.leif.im.BaselnfoModel; 

public class TestHarness { 

public static void main(StringQ args) { 

J //the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModel.setStartingPluglnManager(false); 

// a property sheet infobean to display HelloWorld's attributes 
PropertySheetlnfoBean properties = new PropertySheetlnfoBean(); 
properties.addRawDataltem(new HelloWorldQ); 



1604 



\ 1606 



// add listener for 'OK,' 'cancel,' or close, which generate 'close' events ^ 
properties.addUIBeanListener( 
new UIBeanAdapter() { 

public void closed(UIBeanEvent event) { 
Systern.exit(O); ■ 

} 

} 

); 



V1608 



// a top-level frame to hold our property sheet infobean 
JFrame frame = new JFramefHeltoWortd Properties n );. 
//add a listener for window closing 
frame.addWindowListener( 
new WindowAdapter() { 

public void windowClosing(WindowEvent e) { 
System.exit(O); 

} 

} 

); 



r 1610A 
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Figure 16B 



Continuation of TestHarness java 



// stick the bean in the frame and display it 

frame.getContentPane().add(properties); 

frame.pack(); 

frame.setVisible(true); 



> 1610B 



} 

} 
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Figure 18A 

HelloWorid.java 

r XIS Tutorial standalone sequence example 2 data class, */ 
/*{*/ 

import java.awtColor, 

import java.beans.PropertyChangeSupport; 

import java.beansPropertyChangeListener; 

ryt 

public class HelloWorld { 
/*{*/ 

private int value = 1; 

private Color myColor = Color.green; 



( II this member class helps distribute property change events within XIS 
private PropertyChangeSupport propertyChangeSupport = 
new PnopertyChangeSupport(this); 

//two aux methods to let other XIS objects pay attention to this one 
public void addPropertyChangeUstener(PropertyChangeListener I) { 
propertyChangeSupportaddPropertyChangeListener(I); 

} 

public void removePropertyChangeListener(PropertyChangeListener I) { 
propertyChangeSupportremovePropertyChangeListener(l); • 

} 



public String toString() { 
return "A HelloWorld Object"; 

} 

public String getGreeting() { 
return "Hello World!"; 

} 

UT/ 

pubiic int getlD() { 
return 5; 

} 
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Figure 18B 

Continuation of of HeUoWorld-java 



public /*{*/ int ryi getValue() { 
return value; 

} 

/*{*/ 

public void setValue(int value) { 
// only update and fire property change if this is really a change 
If (this, value != value) { 
int oldValue - this. value; 
this, value = value; 

//fire property change event to notify other XJS objects 
propertyChangeSupport.firePropertyChangeCVaiue w , oldValue, value); P 

} 

public Color getMyCotor() { 
return myColor; 

} 

public void setMyColor(Color myColor) { 
// only update and fire property change if this is really a change 
if (this.myColor != myColor) { 
Color oldMyColor = this, my Colon ■ 
this.myColor = myColor; 

//fire property change event to notify other XIS objects ~) . ^ 
propertyChangeSupport.flrePropertyChange( H myColo^ ,, , V \ft 0 ^ 
oldMyColor, myColor); . J 

} 

\ } ■ < 

} 
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Figure 19A 

TestHarness.java 

r XiS Tutorial.standalone sequence step 2 XIS interfacing. */ 

import javax.swing. JFrame; 
import java.awtevent WindowAdapter, 
import java.awt.event.WindowEvent; 
import com.xis.propertysheetPropertySheetlnfoBean; 
import com.xis.uLUIBeanEvent; 
import com.xis.ui.UIBeanAdapter; 
import com.xis.leif.im.BaselnfoModel; 

n*i 

import jcIass.chartJCChart; 
import com.xis.plot.PIotlnfoBean; 
import com.xis.plotchartviews.LeifChartView; 

ryi 

public class TestHarness { . 

public static void main(StringQ args) { -\ 

//the plugin manager is only required for mpre complex applications 
// involving multiple components integrated at runtime 
BaselnfoModel.setStartingPluglnManager{false); 

HelloWorid hello = new HelloWorldQ; 

I! a property sheet infobean to display HelloWorid's attributes - 1 4 

PropertySheetlnfoBean properties = new PropertySheetInfoBean(); 
properties.addRawDataltem(hello); 

// add a listener for 'OK' or 'cancel', which generate 'close 1 events 
properties.addUIBeanListener( 
new UIBeanAdapter() { 

public void closed(UlBeanEvent event) { 
System.exit(O); 

} 

} 

); 
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Figure 19B 

Continuation of TestHarrtess.java 

// a top-level frame to hold our property sheet infobean 
JFrame propertySheetFrame = new JFrameCHelloWorld Properties"); 
// add a listener for window closing 
propertySheetFrame.addWindowListener( 
new WindowAdapter() { 

public void windowClosing(WindowEvent e) { 
System.exit(O); 

} 

} 

); 

// stick the property Sheet bean in the frame and display it 
propertySheetFrame.getContentPane().add(properties); 
propertySheetFrame.packO; 
propertySheetFrame.setVisible(true); 

// now we create a plot infobean to plot HelloWorld's numeric attribute 
PlotlnfoBean plot = new PlotlnfoBeanQ; 
p!otaddRawDataitems(new ObjectQ { hello }); 
plotsetChartType(JCChart.BAR); 

//the alternatives are SCATTER^PLOT, PLOT, AREA, PIE, CANDLE, 
// and STACKING_BAR, though not all will make sense in this example 

» 

// a top-level frame as before to hold our property sheet infobean 
JFrame plotFrame = new JFramefHelloWorld Plot"); 

// stick the plot bean in and put it up 
plotFrame.getContentPane().add(plot); 
plotFrame.packQ; 
plotFrame.setVisible(true); 



} 






} 
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Figure 20 
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Figure 21 

HelloWorldjava 

r XIS Tutorial standalone sequence step 3 data class. */ 
import java.awt Color; 

// (property change support moved to HelloWorldTranslator) 

public class HelloWorld { 
private int value = 1; 
private Color my Color = Color, green; 

public String toString() { 

return "A HelloWorld Object"; 

} 

. public String getGreeting() { 
return "Hello World!"; 

} 

public int get!D{) { 
return 5; 

} 

. public int getValueQ { 
return value; 

} 

n*i ■ 

public void setValuepnt value) { 
. // all the worrying about change events is moved to the translator, 
// so we just need to do the bare change operation (unless nonXl3 
// components need to listen to PropertyChanges) 
this.value = value; 

} 

public Color getMyColor() { 
return myColor; 

} 

nv 

public void setMyColor(Cotor myColor) { 
' // just need to set the value (see setValue()) 
this.myColor = myColor; 

} 

m ■ 



} 
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Figure 22A 

HelloWorldTranslatorjava 

I* XIS Tutorial standalone sequence step 3 data translator class. */ 

n*i 

import com.xisJeifJm,AttributeGetRequest; 
import com.xis JeifJm.AttributeSetRequest; 
import com.xis.leif.im.Domain; 
import com.xis.leif.im.Translaton 
import com.xis.leif.im.FieidMetaData; 
. import com.xis.domains.display.DispIayDomain; 
import com.xis.domains.movement.MovementDomain; 
import java.awt, Colon 

public class HelloWortdTranslator extends Translator { 

// the domains from which canned attribute metadata will be taken 
- ; // NOTE if an attribute appears in the methods below but its domain 
LIT" \ II is NOT listed here, THE ATTRIBUTE WILL BE IGNORED BY XIS 
private static final DomainQ baseDomains = new DomainQ { 
DisplayDomain,getDomain{), MovementDomain.getDomainO 

}; 

1 ■// store info about the fields, such as whether they are preferred or not 
^ 3 J private ReldMetaDataQfieldMetaDataArray; 

// Return the Domains that describe the Attributes. 
J public DomainQ getBaseDomainsQ { 
V L return baseDomains;. 
} 

// this method returns info on each field defined in the methods below 
/public FieldMetaDataQ getReldMetaDataArray() { 

if (fieldMetaDataArray ™ null) { 

// initialize default metadata 
FieldMetaData dispname - new 

FieldMetaData(DisplayDomain.displayName); 

FieldMetaData pencolor = new 

FieldMetaData(DisplayDomain.penColor); 

FieldMetaData speed = new 

FieldMetaData(MovementDomain.speed); 

ReldMeiaData course = new 

FieldMetaData(MovementDomain.course); 
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} 



Figure 22B 

Continuation of HelloWorldTranslator Java 

// attributes are visible ('preferred 1 ) by default; this 
// turns this off for the course attribute 
course.setVisibiiity(false); 

// the order we put the attributes in here determines the order 
// they appear in tables or property sheets 
fieldMetaDataArray = new FieidMetaDataQ { 
dispname, speed, course, pencolor 

}; 



} 



return fieldMetaDataArray; 



mmmmmnmimmimnnmmMmmnmmmitt 

II the following methods expose attributes of the HelloWorld class; 
// instead of calling the class methods directly, XIS will access 
// everything through this translator class 
//////////V///^ 

public String getDisplayName(AttributeGetRequest attributeGetRequest) { 
return ((HelloWorld) 

attributeGetRequest.getRawDataltem()).toString(); 

} ~ - . 

public Color getPenColor(AttributeGetRequest attributeGetRequest) { 
return ((HelloWorld) 

attributeGetRequestgetRawDataltem()).getMyCo{or(); 

public void setPenColor(AttributeSetRequest attributeSetRequest, 
Color penColor) { 
HelloWorld heiloWorid - (HelloWorld) ' 

attributeSetRequestgetRawDataltemQ; 
Color oidPenColor = helloWorid.getMyCoior(); 
if (!penCo!or.equals(oldPenColor)) { 
helloWortd.setMyColor(penColor); 
// fire property change event to notify other XIS objects 
attributeSetRequest.getBaseDataltem().fireAttributeChanged( 
DisplayDomain.penColor, oidPenColor, penColor, true); 



"A 



} 



} 



public double getSpeed(AttributeGetRequest attributeGetRequest) { 
return (double) ((HelloWorld) 

attributeGetRequest.getRawDataltem()).getValue(); 

} 
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Figure 22C 

Continuation of HeHoWortdTranslator.java 

' public void setSpeed(AttributeSetRequest attributeSetRequest, 
double speed) { 
HelloWorld helloWorid = (HelloWorld) 

• attributeSetRequest.getRawDataltemO; . 
Double oldSpeed = new Double((double)helloWorld.getValue()); 
if (oldSpeed.doubleValue() != speed) { V %2.\Z. 

. helloWorid.setValue((int)speed); 
// fire property change event to notify other XIS objects 
a ttributeSetRequestgetBaseDataltem().fireAttributeChanged( 

MovementDomain.speed. oldSpeed. new Double(speed), true); 

} 

//this is a dummy attribute to demonstrate field metadata ( 
public double g etCourse(AttributeGetRequest attributeGetRequest) { J 

return (double) 0; 
} 

n lf uncomment this to allow reflection to expose additional attributes 
// (see documentation under "Fooling Around") 
// public HelloWoridTranslator() { 
// introspectExcept(new StringD {"value", "myCoIor"}): 

4/ ) 

n't 
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Figure 23A 

TestHarnessjava 

I* XIS Tutorial standalone sequence step 3 XIS interfacing. */ 

. import javax.swing.JFrame; 
import java.awt.event WindowAdapten 
import java.awt.event.WindowEvent; • 
import com.xis.propertysheetPropertySheetlnfoBean; 
import com.xis.ui.UIBeanEvent; 
import com.xis.ui.UlBeanAdapten 
import com.xisJeif.im.BaselnfoModel; 
import jclass. chart JCChart; 
import com.xis.plotPlotlnfoBean; 
import com.xis.plot.chartviews.LeifChartView; 
/*{*/ 

import com.xis.ieif.im.TranslatorRegistry; 

import com.xisJeifJm.LeifDataltem; 

import com.xis.leif.imJnfoModel; 

import com.xis.lejf Jm.BaselnfoModel; 

import com.xis.domains.movement.MovementDomain; 

import com.xis.domains.movement.MovementDomalnWrappen 

import com.xis.leifJm.LeifDataltemDelegator; 

import java.lang.reflectlnvocatonTargetException; 

import com.xis.leif.im.UndefinedLeifAttfibuteException; 

ryi 

public class TestHamess { 

/*{7 , 
protected static LeifDataltem leifHelio; 

static { 

// Register the translator for HelloWortd. in fact this is really 
// only necessary when we have not followed the standard naming 
// convention (see docs), but it can't hurt. 
TranslatorRegistry.getTranslatorRegistry().registerQbjectSchema( 
HelloWoiid.class, HelloWoridTranslator.dass); 

} 

ryi 

public static void main(StringQ args) { 

// the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModel.setStartingPluglnManager(false); 

HelloWorid hello =* new HelloWorldQ; 
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Figure 23B 

Continuation of TestHarness.java 

// a property sheet infobean to display HelloWorlcTs attributes 
PropertySheetlnfoBean properties = new PropertySheetlnfoBeanQ; 
properties, add Ra wData I tem(hello); 

// add a listener for 'OK* or 'cancel', which generate 'close' events 
properties .add U I Bean Listener( 
new UIBeanAdapterQ { 
public void closed(U!BeanEvent event) { 
System.exit(O); 

} 

} 

); 

// a top-level frame to hold our property sheet infobean 
JFrame propertySheetFrame = new JFramefHelloWorld Properties"); 
// add a listener for window closing 
propertySheetFrame.addWindowListener( 
new WindowAdapterQ { 

public void windowClosing(WindowEvent e) { 
System.exit(O); 

} 

} 

); 

// stick the property Sheet bean in the frame and display it 
propertySheetFrame.getContentPaneQ.add(properties); ■ 
propertySheetFrame.pack{); . 
propertySheetFrame.setVisib!e(true); 
// now we create a plot infobean to plot HeIloWorid ? s numeric attribute 
PlotlnfoBean plot = new PlotlnfoBean(); 
plot.addRawDataltems(new ObjectQ { hello }); 
plotsetChartType(JCChartBAR); 

// the alternatives are SCATTER JPLOT, PLOT, AREA, PIE, CANDLE, 
// and STACKING_BAR, though not all will make sense in this example 

// We can set the attribute for initial display on the plot; 
// if we do, this must consist of the attribute name preceded 
// by the fully-qualified classname which ORIGINALLY DEFINES . 
// the attributeDescriptor - i.e., using "HelloWorld.speed" 
// here will NOT work! If the descriptor is not defined in a 
// domain or translator class, then it will have been defined 
// dynamically through introspection when the first instance 
// of the data item is dropped into an XIS InfoBean. 
plot.setYAxisAttribute( 
M com.xis.domains.movement.MovementDomain. speed"); 
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Figure 23C 

Continuation of TestHarness Java 

plotsetDynarnicAdjustment(true); // so axes track value magnitude 
plotsetBarChartAdjusting(true); // needed in some cases for bar chart 

// a top-level frame as before to hold our plot infobean 
JFrame plotFrame = new JFrame("HeltoWortd Plot"); 

// stick the plot bean in and put it up 
plotFrame.getContentPane{).add{plot); 
plotFrame.pack(); 
plQtFrame,setVisible(true); 



// create a leifDataltem version of hello and start a thread that 
// will increase it 
leifHello = 

BaselnfoModel.getBaselnfoModel().getLeifDataltem(hello); 
new Accelerate(); 

/*}*/ 
} // main 

} 



/*{*/ 

// thread to update the speed attribute on the leifHello Instance we created 
class Accelerate extends Thread { 

public Accelerate() { 

super( M Accelerator ThreacT); 
start(); 

} *' 
public void run{) { 

// wrap the LeifDataltem leifHello in a convenience wrapper that 
// gives access to attributes within that domain, if they exist 
MovementDomainWrapper helloMovementWrapper = 
MovementDomain.takeWrapper{TestHamess.leifHello); 
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Figure 23D 

Continuation of TestHarness.java 



while (true) { 

// sleep for 0.5 seconds, then... 
try{ 

sleep(500); 
} catch (InterruptedException e) { 

System.exit(l); 

>' 

// ..update the speed attribute 
try{ 

hslloMovementWrapper.setSpeed( 

helloMovementWrapper.getSpeed()+1); 

} catch (UndefinedLeifAttributeException ulae) { 

// exception if this data item doesnt have this attribute 
System.exit(l); // usually we would do something better 

} catch (InvocationTargetException ite) { 

// sweep up any exception tossed by the underlying raw item 
System.exlt(1 ); // usually we would do something better 

} 

}// while 
}//run() 

};. 



WO 02/46916 



38/90 



PCTMJS01M8418 



Figure 24A 
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Figure 25A 



HelloWorld.java 
r XIS Tutorial standalone sequence step 4 data class. */ 



import java. 
/*{*/ 

import com 
import com 
import com 
import com. 
import com 
import com 
import com 
import java. 
import java. 

m 



awtColon 

,xis.!eif.im.FieldMetaData; 

.xis.domains.display.DisplayDomain; 

.xis.domains.movementMovementDomain; 

.xis.leif.im.Domain; 

.xis.teif.im.AttributeGetRequest; 

.xisJeifJm.AttributeSetRequest; 

.xis.leif.imj^ttributeDescripton 

beans. Property ChangeSupport; 

beans. PropertyChangeUstenen 



public class HeitoWorld { 

private int value = 1 ; 

private Color myColor = Color.green; 

/*{*/ 



public static AttributeDescriptor getDisplayNameDescriptorO { I 

return DispiayDomain.displayName; V 2^£f(?Z 

public static AttributeDescriptor getSpeedDescriptor{) { 
return MovementDomain.speed; . 

} 

public static AttributeDescriptor getPenColorDescriptorQ { , 
return DisplayDomaln.penCoIor; 

} 

/*}*/ 

/*{7 // this property change support code as in step 2 /*}*/ 

// this member class helps distribute property change events within XIS 
private PropertyChangeSupport propertyChangeSupport = 
new PropertyChangeSupport(this); 

// two aux methods to let other XIS objects pay attention to this one • V 'Z- Sfr^f 
public void addPropertyChangeListener(PropertyChangeListener I) { f 
propertyChangeSupportaddPropertyChangeListener(l); 

} 

public void removePropertyChangeUstener(PropertyChangeListener I) { 
propertyChangeSupport.removePropertyChangeListener(l); 

} 
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Figure 25B 

Continuation of HelloWorld Java 

public String toString() { 
return "A HelloWorid Object"; 

} 

public String getGreetingO { 
return "Hello World!"; 

} 

public int getiD() { 
return 5; 

} 

public int getValue() { 
return value; 

} 

/*(*/ // this function as in step 2 /*}*/ 
public void setValue(int value) { 
// we only want to update and fire property change if really changes 
if (this,value 1= value) { 
int oidValue = this,value; 
this.value = value; 

// fire property change event to notify other XIS objects 
propertyChangeSupport.firePropertyChangefvalue", oidValue, value); 

" } 
} 

r{7 

// "myColorVelated methods changed to expose "penColor" instead 

public Color getPenColor() { 
return myColon 

} . - 

public void setPenCotor( Color penColor) { 
// we only want to update and fire property change if really changes 
if (penColor != this.myColor) { 

Color oldPenColor = this.myColor; 

this.myColor = penColor; 

// fire property change event to notify other XIS objects 
propertyChangeSupport.firePropertyChange( w penColor ,# , 

oldPenColor, penColor); 

} 

} 
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Figure 25C 



Continuation of HelloWorld Java 

// expose toStringO return under a new name 
public String getDisplayName() { 
return toStringO; 

} 

// expose "value" under a new name 
public double getSpeedQ { 
return (double) getValueQ; 

} 

public void setSpeed(double speed) { 

// we only want to update and fire property change if really changes 
Double oldSpeed = new Double((double)this.getValue()); 
if (speed != o!dSpeed.doubleVaIue()) { 
setValue((int)speed); 

// fire property change event to notify other XIS objects 
propertyChangeSupportfirePropertyChange("speed", oldSpeed, 

new Double(speed)); 

} 

} 

ryi 

7*{7 

// store info about the fields, such as whether they are preferred or not 
private static FieldMetaDataQ fieldMetaDataArray; 

// this method returns info on each field defined in the methods below 
public static FieldMetaDataQ getFieldMetaDataArray() { 

if (fieldMetaDataArray == null) { 
// initialize default metadata 
ReldMetaData dispname - new 

FieldMetaData(DisplayDomain.displayName); 
ReldMetaData pencolor = new 

FieldMetaData(DispIayDomain.penCoior); 
ReldMetaData speed = .new 

FieldMetaData(MovementDomain.speed); 
// could customize the field metadata here 
fieldMetaDataArray = new FieldMetaDataQ { 
dispname, speed, pencolor 

}; 



} 

/*}*/■ 
} 



} 

return fieldMetaDataArray; 



J 
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Figure 26 
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Figure 27 A 
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Figure 27B 
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Figure 28 



WO 02/46916 



46/90 



PCT/US01/48418 



- u lib- 




^910 

^2935 

(3) Searches component for resources defined by the PtuggabteService 



Performs actions on resource found 



PluglnManager 



^940 

(4) Add resource 



930 



Application Component 



(2) Loads other 
PluggabfeServices 
into RuglnManager 

r 

2920 





^2905 




(1) Load initial PJusgabteService 

^2915 










PluggableServiceFinder 





925 



Figure 29 



WO 02/46916 



47/90 



PCT/US01/48418 




Figure 30 
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Class ContentlnfoB.ean 

I • 
+- ~java_. aw t . Compo nent ' 
1 

+ — jaya . avfc . Cont ainer 

I ' • • 

»— i avax . s wing . JC o tnponent 

! ' 

I . ' 
+--SSP j frU 8 Hi -Abst yac tJUI&garj 

^-^ra^3aeU.^n^obQan3 T D^taTtem^;njL P^3Qan 
1 

+»- com. xia . inf obeans . content. Con ten tlnfoBean 

All Implemented Interfaces: 

Accessible. BeanContextChildOwner. BeariContextChildOwnerDeleq at qr, BeanContextProxv . 
BeanContextScrvicesQwn er Delegatof . Clipboard User. DataltemSink. ImageObserver. MenuContainer. 
, Serializable, SiateSavafrje, t/IBean 



public class ContentlnfoBean 
extends DataU emSinkUIBea n 
Implements ClipboardUser 

The ContentlnfoBean class is a visual component that displays the contents of a raw data item. If no contents are 
available, it defaults to a split pane containing the JAF menu and the PropertySheet of the raw data item. The contents 
may have be multipart, and may be text, html, rich text, or an image. Multimedia support will soon be added. 

Author • 

Jaime Garcia, Polexis, Inc. 
See Also: 

Serialized Form 



inner classes inherited from class javax.swing.JPa_nej 
jpan^U Accessible Jpanel 



Inner classes inherited from class javax.swing.JComponent 
jgomppnent; . Access k Ms JCojnppngpt, 



Inner classes inherited from class java.awLjQ&rjJ^ifler 



Co.ptainer.Acces3j.bJLeAWTCo^t,airie]; 
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Inner classes inherited from dass java.a^Yt. Coroponent 



Field Summary 


static txQ54fft*3M££»£vti<U v 


RESOURCES 




localized resources for this view object. 



Fields inherited from class ccm.xis.ui.AbstractUlBeafi 



Fields inherited from class javpxswn g J Cam p_o nent 



af -r.***ibl»g Q nte X t, Liater-erList, TOOLJT I P JT EX TECS* , ui, HgPEr^NBO.CqNQmW. 



Flelils inherite d from class jaya.awt.Co.rnp,on,en$ • 

b^qh^l;;snji5ni, &&asjE£jmv&Ji, iznMismia. u^m^ui^^i. ™?j^£KmmT~ 



Fields inherited from interface javB.awtimagc. ImagcOb3erver 



abort . ULLarrs . error , frahebits, amHX/ lEffiEEBIISa. gQElgglls, MIGIH 



Constructor Summary 

.Coateatlnf oSe^n ( ) 

Default constructor thai creates an empty ContentlnfoBean. 



Method Summary 


. void 


a ddita wDa talt.eai I Ob j ect rawDa taltem) 

Load the raw data item into the ContentlnfoBean. 


void 


addRAwQa.i;a^tarMi { Object U rawOatal Cams) 
Add the raw data items ia the array. 


bcoUan 


canCleact) 

Return true if the ContentlnfoBean has an object and it is selected 


boa lean 


canClaar (Cbiact {■] items) 

Return true if the specified items can be cleared. 


boolean 


caciCopy { ) 

Return true If the ContentlnfoBean has an object and it is selected 


boolean 


canCpBx { Qbject ( 1 i t ems ) 

Return true if the specified items can be copied. 


boolaan 


caxiCutt) 

Return true if the ContentlnfoBean has an object and it is selected 




eanCut t Object fl items] 

Return true if the specified items can be cut 


boolean 


canPaate ( ) 

Return true if the CoctentlnibBean can paste new objects, false if not. 


aoQlcan 


canSaloctAllU 

Return true if the ContentlnfoBean can select all objects. 
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boolean 


Return true ifthe Content! nfoBean can un-sclec: all objects. 




clear { ) 

Notify the ContentlnfoBean to remove the current raw data item only if it is selected. 


veld 


clear (Object ( } items) 
Clears the given items. 


void 


Removes the currently loaded object. 


boolean 


contains {Ob iectf 1 items) ' 
Heoirn true iFthis ContentlnfoBean contains ail the objects of the given array. 


boolean 


confcainsCoapo nen t ( Cocoon e n t component) 

Check if thr given component is contained by this JnfoBeon 


void 


cory (CAJtP.bjqgid clipboard) 

Called to invoke this Co ntentlnfo Bean's copy action, which is to copy all selected data 
to the Clipboard. 


»old 


aoDvdLiDboatd clioboard. Oblectfi items ) 
Copies the given items into the Clipboard. 


. protected void 


cr ea.teConten t { ) 

Method called when there is no content to display for a raw data Hem. 


voic 


©utfCHoboacd clipboard) 

Cm selected items from the ContentlnfoBean and post- them into Clipboard. 


wo id 


cutf Clipboard clipboard. Oblactn iterxs) 

Cut the givenitems from the ContentlnfoBean and post them- into the given Clipboard . 
only if they occur in the ConteutinfoBean. 


protected -Container 


«retCor\iialnerFcrCoatenfc(inc index) 

Get a container with die contents of the content object at the given index, or null if the 
content type is not supported. 




^•tContantst () 

Fetch the currectly loaded raw data item 


JAf ftndp r opg rt YCgre on 3.* r . 






Get the JAFAndPraperty component used by the ContentlnfoBean to display the 
contents for raw data items that have nothing else to display. , 


• ■ Jteim 


^otitti^na-rAltesaMenutLeifDataltem dataltem. boolean shcvCut Pas tel tena) 
Pwctum the data item menu for a LeifDataltcm (usually the selected LeifDataltem). ' 




getile.sou^ses, 0 

Return the Resource Bundle for this ContentlnfoBean. 




ge_tS^leqtadObjects ( ) 

Get an array of selected objects. 


void 


Messaged to indicate an InfbModel change for this LnfoBean or cne or mere of its 
LeifDataltems. 


beolean 


Is Creat lngcqn tjent t ) 

Check whether default content creation is set 


boolean 


isOrag£riablad{ ) 

Return true if the default Drag support is enabled. 


boolean 


Return true if the default Drop support Is enabled. 
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oooUan 


isSaloctadO 

Check the selected state of the content object, if there ts currently one loaded. 


boolean 


isJCISNctif ying t ) 

Check whether the Con tent Info Bean is updating based on XIS events and Is notifying 
XIS of raw data item attribute changes • 


void 


naafce (Clipboard clipboard) 

Paste die data Objects from the given clipboard.- 


rcld 


removeAllRavDatal tems { ) 

Remove all of the raw data kerns chat are currently loaded 


raid 


ceaavBRawDatal teg (Object ravrQa taltem) 

Remove the given raw data item if it is the cunemry loaded raw data item 


voia 


'romovaaawDataltdrtLfl (Obi set I ) rawOatal terns) 
Rsmove the raw data i teens in the array. 


void 


se£eccAli{> 

Set the selection state of the object to true. 


void 


Set the selection state of the object to false. 


void 


3 otCce a teCpn tent I boolean create) 

Set whether content should be created for objects that do not have any displayable 
content, via a JAFAndPropertyComponent. 


void 


a o to r&gSnabled (boolean enabled rag) 
' Set the status of the default Drag support. 


void 


afttDra^OvmerProxv(DraaOwner draaProxv) 
Set a DragOwner "proxy" for this InfpBean, 


void 


ae tP-opSnabled ( boolean enabiedrop) 
Set the status of the default Drop support 


void 


setDronOvnarPrarvtDcocOwner drooProxvl . 

Set a DropOwner "proxy" for this InfoBean. ■ - 


• void 


sets elect! on (boolean selected) 

Set the selection state of the content object ' 


void 


a etxisw.otifyinc (boolean notify) 

Set whether the ContentlnfoBear. should update based pa. XIS events and should notify 
XIS of raw data item attribute changes 



Methods inherited from class com.xtsJeiLiarobeans. PataItemSinkirfBean 



addcAFPcoulator , addRavDatalberna^aGroup, add?e yvj.ee/ SlOlS. 
craateBaan ConcextServiceaOvrierDslgcator. dj^pqaft. ge,tp^a.nqont;e^fcPrQttyj 
ggtSeanContaxtServices , getS aCorfce xt, getlngoModel. cet JAgPgpwlafcptrs, 
aetLeifData lteniHenu. cjet^ffPaftaytetnMepu, qetl#iZDa%&Xte?Wen\x t qesHsngBas. 
aetOwnedBeanCocitextChild . cetService , sa£Se£vic£, gefrServyiq, qatSbatuaBara, getTpolftara, 
fljSUOU, inifcializeBaanContaxtReacurcas , ini,t4a^j t 2aB«a,rACQnt;eM;^eyylc^ > 
Anvfllldateln- f 0ttfldel, AsPrqpPagtgSnafrlpd, MKand:UpgqUpfr?ardOp« talons, 

• reieaseBea nCftncaxtRe^ourcea , rftiftrt««BaanCQnr.Rxr;SftTrvicea. EevoK^choEegDiaiagProytfler, 
revckerraniB Provider, revokqserylcg, aafcPyqp?g3ceEaajaJ t fid, aetttan^unqCUtaQarriOpe. m tons . 

,vaUdat^.«?P.dj,t\<;SgtBftangajitqnt; 



Methods inheri ted from class com.xis.uLAjtslrjt^U/lBgAa . 

addUiaean l t fcj t . ar.ar .' flnalrze . oetShortT itle. qetTltle, cetUIComoonants. isftccive . 
laCloififii, isCloseOK . oroceaaUIBeanEvent , Kairpyep;rB5frrU.latenQK, CftqtQEfiStftKa, savaStaAfl, 

.ssxAsUys, aflEShQtciitle. s^lirie ■ ■ 
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Methods inherited from class iavax.5>ylrig JT > anel 



qetAccfls 5 EbjeConEext; , qetOrClass CD, oaramStrino. uodateUI 



Methods inherited from class javajcswiog JCQmponent 



aflaA.nce3t,ocLA5t,aner, addHofcifv, addPcopertvChanaeLiater.er , adcFropenyCha^qeLls cener . 



addVeeoableCnaruxeLlatener, computeVis iblaRect , contains , crgateToolTip . disable , enable, 
gAEePCQPer^yCfonq^ f iraPropertvChanoe. f ireProoectyChanqe . firePropectvChanoe , 



IiraPrQpertyf;h.a,nqe, El ga ProoertvChar.qa. f ireFropertvChanoe . 
UcsgKQPSgtyCnqng,q, j i taVatoab^phanqe., qacfietionForKevStrcke . cetActionHap . 
qetAlicrtinentX, qetAlionmentY, qetAutoacroLLs. qetBorder , qgCBcunds . o etc lient Proper t;v . 
qetCoiroonentCraqhics. cetCondltionForKe vSt roke , oetDebuaGcachicsQct ions . q etGraohiea . 
qetHeioht, qefclnpijt;gtea, catlnptitMap. cetlnput Verifier , qefclnseta , oetlr.aeta . 
qatLiatenera , qetLocation , qa -Maximums ize. qetMinimumSize , getNextrocuaabUComponenc . 
qetPreferredSlzs . qeCflgqlgtSf ftdftSYSE roKft3> oatRsotPane. qatSiza . qatTcompLocation . 
qetToolTipText, qetToolTlpT^r^, Q»t;TqpI#evq 1, Ancestor, getvgr i f vTnpuf When FoeusTa raat . 

3a£VjgjktelaEa££> getwidch, gets, aa£Ir qcabrocua. aa ar a cua* txiOe- iaflouliiflgulXaxjBjg, 

isFocusCvcleRoot, ia FocusTra ve raable , iaLightw eightConrPonent , isManaqlnq Focus . 
^sHa^juny^SizgSet;^ i^in^raurngjUeSefc, ftaOpaq^ie, isOptinizedDcawinoEnab led. iaPaintintrTi 1» 
U£Ca£g£jESta5mSfl£» LaflafflJ&al Focu 5 Enabled, IsVaL^dAteRoot, paint . qaintBcrder . 
RflJ^n^qhi t) lctcqq l pai,nt;CcHPpqnent; ( palrUJtigasalfll&ly* oaintliwned lately , print , orintAll . 
PXlnt Border, printChildren. pxintComponent . procesaConPonentKevEvgnt . orocessFccuaEvent . 
orocessKevBindinq. orocgag Key Event. proceaaMouseMotionSvent. put Cllent Property , 
CgQ^StgCKeYfaoardAcPiffifl, regis terKeyboardAct ion , . removaAnceaCorLiataner , reinoveNotif v , 
^moYePrQCgrtYCh^nqgUs^nqr, renqva Prope vChanqel, ft st; a per, cernoveVet oableChanqeLiatener ,. 
fepai,nCr cgP4i.nL, rfinueSCDeTau 1 r f PCUP > request; Foctis, rasatKavb oardActions , reshace . 
r_6validttce , scrollRectToVlslble . seCflCtlQnflaP* setAlionm&ntX. satAlicnmantY . 
aetAutoacrolla , aetSackqrcuRd . secBorder , aetDebuoGrgphiEsOprlans . setOoubleBuffered , ■ 
ag.t.Enableci, ^etFo^t;, set For ground, SgSInPU tflftP, satlnoutVerlf lar. satMaxlmo.-nSlze. 



jsefcHj.qLrpdmSize, sei;NextFq^3abJ.eqomponent,, aetOpqcme, aetPre ferradSize 
gtR$qugfftroC"3Snablec;, aerTQQ WpT«*^ SSlSLL, setVarify rnputWhanFocuaTarqet , 



Methods inherited from claas fava.awL Container 



add» add/ Sdd# adg> add, addqqRtajLBg rUSXgnS E > dAOHnOl* CQUntCPmPOnBHt dS?- V^erEvant;, 

doMyou,^, findCoTnpop.cn.Eftft, findCoaipongptAt;, qetCQW?pr.gn.E > qqcConiBOftentflt, qeLCo?tp<>nen,^, 

qetCopipcpentCount, t_Co:npoagn&5, qetl^ycut,, in^3- iLn^UdftCfi. IsAncsstorOf , layou t, 
lifil. locale, pinimumgisfi, RaAnsggmpprjent;?, pregeg£e.dg„U.C Pgin tCgfropngntS r 

gJO^^SConta^Pgr^v^t;, prqcaaagvent;, fisirtayg, remove r^enioyeAU, , rgtrvQV£CjSJVUlnag,U3t.fingJ, 
.aetLayout;, vaAi^IS, yqiiflatqTESa 



Methods inherited from dasa jaya,aivL Component 



a q t ;j.on , add, flddCqmp p nc n t u i 3 1 ener , add^ Q yua List ene r , addKlerarcftygqu i 
aridHwarchvListaner, . addr . riputMe bnqdLii a tertqy , addKcvLiatencr . addMouaeLiscene r. 
addrtOU^sMQtjLOP.U^tenag, bound?, c.heckfrnage., c^qcklmaqe, ccaleacaSvanta , contair.a , 
CJCeatglff^gjBL. Creaiflimagj, di sable Event; s. f dispa»ch^veqt> goable , ehablggventa , 
ftflajaielnPU^gtnQda, qa^9ac)cg!:Quridr SSifiOJJQjiS* qe^Qq;pr^oda^ qe^Cg^PonennOrian^ati^qn^ 



gsiQii50£. qetOropTaraat , gefcFont , qe^ron^Qtcjcg, 
QetCcaptUcaCorilUqUCfltioo, qe^^nputjCon^e^t;, catlrtPutMethodRaouas ts ■ qet;I,qcalft, 
Zf£LQca£i£in, qft^pqatj,qnOnSqreen, get^ame, gjsXZSS^HXr qe^Peqr, qetslze, -gatToolkii: . 

g^lifiSiiStJt, gatlasLUfi, handleSyenc, imaqetfpdA^g, iasi^/ iaDiapiavabie , isEnabie.d f 
j^^igq^i^t, ; a shQwj,ng, UVflUd, iimiiOs, KfiyPavn, KavPp, UaI. Uai. Uai, tsmElas, 

loJtFocuj, mous sDown. pamftPxag* BHUflaSatBT* mflllAfi£ai£* mouse Hove, KQmsfiUP* Pove> 
ggH^rocuj, paintAll , ppatEvent . pr^pareXmaqq / B.£gPaceXmaqe> CXOi 



:,as sH jj e ra r ch yBqund j ve n 5 1 proqeaa^ j,g,rarpr^YE;vent; , prccasalr.PU t«e> t; h,pd£ va^n t; , 
PrQCe??MouseEvant; r remove, raraovgCompgnan t Li s t ene r , reroqveFqcuj^lJt^n^f > 
remgv8HlgrarchyBpund^^^t;^f\er t r.etnoyaH Ufia zrchy^a t c , remove ^nputHgt;hqdLig>;er\a ?f 
retnpyp.Key^lstensr, removqMquaqI^i,s^ e ngr> £3thg va^oya eMo t i onLi,^ t e ne r , r_£oa_ir£, tepajjlt, 

^tQgppTarget, aetLocale , aetLocation, aa^Lo^tlon, aet^a^g, *£l£l££, gej^g, aj^ow, 
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Methods inherited from elajj j a* a. Ian g. Object 

c^ope, equals,. g&bClaaa, haahCodc, notify, notigvAll, wale , wait, wait 
Methods inherited fr om Interface com.ils.uL CliobDardLfcer 

i3^pdlingC;ipt?pa]Cd0aacaClQria. SgtHflntUlngCl iDBo^rdQce rations ' 

(Methods inherited from interface com. xls.uLUl Bean 

Field Detail 

RESOURCES 

public ssatic final TvetedReaourceBundle R2S00HCSS 
tocilized resources for this view object. 

Constructor Detail 

ContentlnfoBean 

public Conb*ntXn£oa«anO 

Defcult constructor that creates en empty ContentlnfoBean, 

Method Detail 

. gctContents 
public Qblect ;patContaniL* ( } 

Fetch the currectly loaded raw data item 
Return J : 

the currently loaded object, or null if no object is toadsd 
setXISNotifying 

public void »«txxsHotif r i 0 g(bool&an nobiCy) 

Set whether the ContentinfoBean should update based on XIS events and should notify XIS of raw data item 

attribute changes 

Parameters: 

no 1 1 fy * if true then notify XIS, else do not . 
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. isXISMotifying 

public boolean isXlSHotifyingt ) 

Check whether the ContentlnfoBean is updating baaed on XIS events and is notifying X15 cf raw dat3 item 

attribute changes 

Returns: 

true if it is notifying XIS, else false 



removeAlUUwDataltemi 

public void ramavuMJJliwDa.taltamfl [} 

Remove all of the raw data items that are currently loaded 



getRejources 

public TypedrA s sourceDundle setfloaouxcaa O 

Return the ftesourceeundle for this Content In JoBaan., 
Overrides: 

Returns: 

the statically sourced ResotirceBundle. 



mfoNtodelChanged 

public void infoModelChangadO 

Messaged to indicate an lufoModel change for this lafoBcan or one ot more of its LeifDatal terns. This should 

reload all currently loaded data items to pick up mfbModcl changes. 

Overrides; 

AnfoMoflelCftancec in class c a c ei cen Si nkU i a a an 



addRawDataltems 

public. void addRawSataltasus (Object H raw&atal terns) 

Add the raw data Items in the array. Wjli only add if the array has only one object and the object is not the 
-currently loaded rawDataltern, 

Parameters: N 
cawDetaicema - the array of objects to be added 



addRawDataltern " 

public void addRavO a fcal fcoa ( Object raw Da tat t err. ) ' 
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Load the raw data item into the Content! nfo Been, [f the raw data iietn -supports the ContentDomain and has " 
content of type that is currently supported then it w||i be displayed. Otherwise, if content creation is set to tme then 
default content will be created, using a JAFAndPropertyComponent 
Overrides: 

addRawOatalte m in class Qa ta I tcmS inkU iQean 
Parameters: 

rewoataltem ' the raw object to display _ 



createContent 

protected void eraafcoContant ( ) . 

Method called when there is no content to display for a raw data item. The default behavior displays a 
JAFAndPropertyComponent of the object, but subclasses may wish to display something else instead. 



k isCreatfngContent 

public boolean isCreatlngCantent ( \ 

Check* whether defedt content creation is set tf so then a JAFAndPropertyComponent will be created far items 
that have no displayable content. 
.' Returns: 

true if default content is created, else false 



setCreatcContent 

' public void setCroateContent {boolean create) 

Set whether content should be created for objects that do not have any displayable content, via a 
JAFAndPropertyComponent. 

Parameters: . 
create - if true> create content, else do not 



removeRawDataltems 

public void renioveRawOataltama { Object [ 1 rawCa talc ema) 

Remove the raw data items in the array. Will only remove the object that is currently loaded if. it is contained in die ' 
array 

Parameters: 

eawData I terns -the array of objects to be removed 



removeRawDataUera 

public void removeiUvDa.t3iItein (Object cawDataltero} 
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Remove the given raw data item if U is the currentiy loaded raw data item 
Overrides; 

taaojiejla *2<3ia l££3 in class aaXAli^ sSln kUlfca^j} 
Parameters: 

rawOataltosi - the object to remove . 



getJAFAndProperryCoraponent 

public J ArAr.dPs qB^^ ^yCDsioongnt gatJXTAndPrcpertyComponeat I) 

Get the JAFAndPropcrty component used by the ContcntlnfoBcan to display the contents for raw daia items that 

have nothing else to display. 

Returns: 

the currsnt J AFAndPropertyComponent being used 



getContainerForContent 

protected Contains r getCoat*irwpFo*Confcant tint index) 

Get a container with the contents of the content objec/ai the given index, or null if the content type is not 

supported Subclass this if you need support for a type that is not already supported. 

Parameters: 

index ♦ the index of in the object 
Returns: 

a Container with the contents at the given index 



getSelectedObjects • 

public Qfci£C£U gatSelectedObjecta O * 

Get an array of selected objects. This will return an empty array if there are no sheeted objects. If the raw data 

item is selected it will return an array of sisc I with the raw data item inside ' 

Returns; 

an array of selected objects 



isS elected 

public boolean isSelectedO • 

Check the selected state of the content object, if then* is currendy one loaded. If there is none, return false. 
Returns: 

true if there is an object and it is selected 



seiectAll ' 

public void seloctAilO 
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Set the selection state of the object to true. 
Specified by: 

Sfaq?KftU in interface ClipboardOser 
Overrides: 

5£i$cXA_U in class .Q^J^aiSi^iaaAQ 



selecfciVone 

public void selBctKone I ) 

Sec the selection state of the object to false. 



setSeiection. 

public void sets election (boolean selected) 

Set the selection state of. the content abject 
Parti meters: 

the -new selection state 



canCIear 

public boolean canCleaxO 

Return true if the ComentlnfoBean has an object and It Is selected 
Specified by: 

canCiear in Interface ClipboardUaer 
Overrides: 

qanCMftC in diss p^taltemSj^kOIjBaaii 
Returns: • • 

true if the raw data item is selected 
See Also: 

gessglftCtBclQMecCa 11 



canCIear 

public boolean caaClaaj ( Qb 1 a c t f 1 items) 

Return true if the specified items can be cleared If the item ts not in the ContentlnfoBean return false. If there is 

more than one item return false. 

Specified by: ; 

canCIear. in interface CliphoardUser 
Overrides: 

CaPUgfl? in Class DaEaltemSinkUXBaan 
Parameters: 

iteffj; - the Array of items to be cut 
Returns: 

true if all of the items are present, otherwise false. 
" See Also: 
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contains ^ObjecrU) 



canCopy 

public boolean canCopy O 

Return true if the ContenOnfoBean has an object and it is selected 
Specified by: 

c anCopy in interface CiipboardUser • 
Overrides: . 

canCopy in class Datal tgtnSinkCIBean 
Returns: 

true it the raw data item Is selected 
See Also: 



ca n Copy 

public boolean eanconv ( Object CI itentsf 

Return true if the specified items can be copied. If the item is not in the ContentlnfoBean return false. If there is - 
more than one item return false. 
Specified by: 

cancoov in ioterfaca cliche a rdliaer 
Overrides: 

saaCsgy in class jBfltflU«*SlnKUIBs6a 
Paramcten: 

items - the Array of items to be cut 
Returns: . 

true if all of the hems are present, otherwise false. 
See Also: 

£an£lj**r (Object (J * L 



can Cut 

public boolean canCutO 

-Return true if the ContentlnfoBean has an object and it is selected 
Specified by: 

canCut in interface CliPboardUaer ■ 
Overrides: 

canCut in class QafcartemSinkUlBean 
Returns: 

true if the raw data item is selected 
Set Also: 

cajlCle&rU 



canCut 

public boolean canCut (Qbj£c£ ( I items) 
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Return true if the specified items can be cut. If the item is nat in the ContentfnfoBcan return false. If there is more 
than one item return false. 
Specified by: 

<aacui in interface ciipjioftjcdiisjej 
Overrides: 

canCut; in dais Da I tem5inkUI3ean 
Parameters: 

i teres -the Ajray of items to be cuL 
Returns: ■ . ■ 

true if all of the items are present, otherwise false. 
See Abo: 



canPaste 

public boolean can?»stLa() 

Return true if the ContenUnfoBean can paste nevy objects, false if not. 
Specified by: 

eanPaate Li interface ClioboardUasr 
Overrides: 

cangftsa* indass DecflXCBffStRKmgaaA 
Returns: 

default is always true for the ContentInfo3ean. 



canSelectAll 

public boolean eanS«leetAl.l ( ) 

Return true if the. Content! nfoBean can select all objects. 
Specified by: 

canSelecsAU in interface CUaftqardUgU 
Overrides: . 

car.aglgeHAll in Cvass QaeattamSinkOiaear. 
Returns:" 

returns true if there is on object end it is not selected 



canSelectNone 

public boolean canSelectNone ( ) 

t Return true if the ContentlnfoBean can un-sclcct all objects. 
Returns: 

returns true if the raw data item is selected 



clear • 

public void clear 0 • 
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Notift the Cor.tentlnfoBean to remove the current raw data item only if it is selected. 
Specified by: * * 

clear in interface Cllsboardt'ser 
* Overrides: 

Gijtar in class Daj^U^L*iisyjB^n 



dear ... 

public void cl«ar{Obia££{] items} 

Clears the given items. These items only get cleared if they actually occur in the ContentlnfoBean. 
Specified by! 

s.teAZ in interface Qi.iRbsaEslUafiX 
Overrides: 

clear in class { 
Parameters: 

• items - the Hems to cleared. 



clearAU 

public void dearAllO 

. Removes the currently loaded object. 



copy 

public void cop.ytC3,< ?boa,g2 clipboard) 

Called to invoke this Co riten tin fo Bean's copy action, which is to copy all selected data to the Clipboard 
Specified by; 

CBfiy. in interface clipfrpardUser 
Overrides: . ■ 

Parameters:. 

clipboard - the Clipboard object that gets posted to. The actual hems posted are contained in a 
LeifTransferable, . 



copy 

puOliC void copy ( C li . pbo a.?d clipboard, . 

Obi act f \ items) 

Copies the given items into the Clipboard.. 
Specified by:*. 

copy in interface f^lp>^ardOsg_£ 
Overrides: 

£^"v m class Qft^alfc.cinSiftfrUIBean 

Parameters: . t 

clipboard - the Clipboard object that gets posted'to. The actual items posted arc contained in a 
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LeifTransferable. 

items • the array of Object items to copied. 



cut 

public void cut {Clipboard clipboard) * 

Cut selected items from the Content In fa Bean and post them into Clipboard, 
Specified by: 

cut; til interface ciioboardUser 
Overrides: 

gyj; in class Datal tomS.i nfrOXBQa p 
Pnramatars: 

clipboard - the Clipboard object that gets posted to. The actual items posted are contained in a 
Lei (Transferable. 



cut 

public void cut ( Clipboard clipboard, . 

Q£Lt£C£U items* 

Cut the given items from the ContentlnfoBean and post them into the given Clipboard only if they occur in the 
ContentlnfoBean. . 
• Specified by: 

cjifc in interface gij gbo&rduaar . 
Overrides: 

cut, in class OatAltcmginkUIBeah 
Parameters: • 

clipboard - the Clipboard object dial gets posted to. The actual items posted are contained in a 

LeifTransferable. 

items - the array of Object items to cut and posted. • 



paste 

public vc'id paate ( Clipboard clipboard) 

Paste the data Objects from the given clipboard. This retrieves the clipboard contents and does a simp.ls add, 
Specified by; 

paste in interface clinboardgsar 
Overrides: 

Parameters: 

clipboard - the Clipboard thai contains the objects. 
See Also: 

. e-idAawCia t ? I tema (ObjectJ JJt 



- contains 



public final boolean contains (Q&i£££ C J Items I 
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Return true if this Content Info Bean contains alt tie objects of the given array. 
Parameters: 

items - an array of objects to locate in the ContentJnfoBean. 
Returns: 

true if there is only one object and U is confined, false otherwise 



containsComponent 

public boolean coKta-LnsComponent ( Component component) 

' Check if thr given component Is contained by this [nfaBean 
Parameters: 

component - the Component to check for 
Returns: 

true if It is contained, else false 



getLeifDataltemMenu' ... 

public JNanu catLqifDatal tcnfeiaaii I Lei £ Oa ta 1 1 am datattara, 

boolean ahowCutPastel terns) 

Return the data item menu for a LeifDataJtemXusualiy the selected LeifDataltem). this is used by che menubar to 
add menuitems from this JMenu to a Data menu if there is exactly one DataltemSelected selected. 
Overrides: 

g e t t.e i f Oa t a 1 1 emM e a u in class OataltemSinkqiBean 
Parameters;-. 

dataicem - the LeifDataitem to get the menu for 

showCutPaatel tema - true to allow cut.and paste items to appear, false to omit them. 
Returns: 

the JMenu for the given LeftDataltem 



isDragEnabled 

public boolean isO rag enabled |) 

Return true if the default Drag support is enabled. 
Overrides: 

^nraasnabied in class 2atflIt,sffiSlnkOI£gan. 
Returns: . 

true if drag is enabled, felse if not, default is initialized to true. ■ 



setDragEnabled 

.public void $ e to rag-Enabled (boolean enabledragj 

Set the status of the default Drag support 
Overrides: . 

segPracEnabled in class Pata.Itern5lnKJaBeflQ 
Parameters: 
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enabladrag - true if default drag support- should be used, false if rot. 



sctDragOvvnerPrdxy 

public void aetflraoQwiiarPraxvt DraaOwngr draaProxy) 

Set a DragOwner "proxy* for this InfoBean. 
Overrides: 

se»Di;aqOv/riey?tr ? KY to class DataltftttSinkUtBftan 
Parameters: 

dragFroxy - a DcigOwrier implementation. 



isDropErjabled 

public boolean isDrcpKnablad { ) 

' Return true if die default Drop support is enabled: 
Overrides;. 

ISQmpKnabUd in Class Datartan^i nkPIBgan 
Returns: 

true if drag is enabled, false if not, default is iaittaltzed to true. 



setDropEnubied 

public void setDropEnacled (boolean enabiedcop) • 

Set the status of the default Drop support. 
Overrides: 

ae COiocEna bled in class OataltemSinkOIBcan . 
• Parameters: 

enabledrcp - aue if default drag support should be used, false if not 



s e tD ro p Ow n erP ro ry 

public void aatPropOwnarProxy ( PropGwriey dropProxy) 

Set a DropOwner "proxy- far this InfoBean, 
Overrides: 

* * aetDrooOwnerPrexy in class Pa t a I c gm SinkU Tap, 

Parameters: # 

dropPxoxy - a DropOwner implementation. 
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PackagecorruxisJeif.ini 

This package contains classes that provide the APIs For using information management in applications. 



See: 

Description 



Interface Summary 


Attribute 


The Attribute class represents an attribute for a particular data type. 




The A-ttributeAlias indicates an alias from L.n Attributes to a single Attribute, together 
with a precision level; the higher the precision, the better the alias. 


Attribute Factory 


The At tribute Factory class allows an implementor to return an appropriate Attribute for 
the given Lei fDatai tern. 


AtfotbutjeLookuR 


The AttributeLockup interface is used to lookup Attribute objects for a particular data 
item. 




The DiaplayLabel Interface defines methods that arc needed for use with 
D isp layLabelA ttributes. 


Domain 


This interface describes the basic fields and methods possessed by all Domains. 


InfoModel 


The Inf oModel interface is the interface that is used to convert raw data items into 
LeifDatal terns. '* - • ' 


LeSfDatftftem 


The Lei fData Item interface represents a simple data item. 


Ixi/QatafremOtterver 


This class is used for observering a LeifDatal tern to know when it has finished processing an 
action. 


UteDatafiem 


The Li teOatal tern interface represents a data item. 


PropcrtvProvider 


If a Property Provider implementation is added to services it can be used to replace the 
standard behavior when a PropertySheetView is opened from a JAF menu or as a default 
command. 


RawDataftemttOQkitp 


The RawDataltemLobkup interface is used to look up a raw data item from a unique id. 



Class Summary 


AbstractAUribute 


The AbstractAt tribute class represents an Attribute. 


Attribute A liasPluggableService 


This register AttributeAliases. 


AttrlbutePescriptor. 


The AttributeDescriptor class is used to describe an 
attribute without providing functionality of how to use the 
attribute. 


AttributeDescriplorFactory 


The AttributeDescriptcrFactory class is a singleton 
class used to create or get AttributeDescriaLors. 


A.ttriMie£a ctoryjnfoModelSubsej 


The Attribute Factory InfoModel Subset class 
provides an InfoModel that will add the Attributes specified 
by the AttributeFactories to all LeifDataltems this 
InfoModel creates. 
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Attribtiteflcf Request 


Th* Hrr ri Silt pHf t*ftAmin*i* rlACt ic frfi nsrL'ao* a l! 

the necessary parameiers for getting the value an attribute. 


Atiriuo£eLoj:fcJ*eque.tt 


The Att cibuteLcc kRaques t class- bundles attributes 


Attributes 


The Att cLbutea is a container for holding attributes. 


AtJribuieSejRecjues.t 


The AttributeSet Request class is used to package all 
the necessary parameters for setting an attribute. 


BajtpataJiem 


The aaaeca.tal tero is the first wrapper around raw rfoa " 
items. 




//PENDfNG(RK): Any method marked with "PENDING" in 
the JavaDoc will //Uicely be removed before XIS is released, 
in final form. 


. £.a?e(oroModc!S(?rYi<:e«f rpvlder 


The Baee In foModelSer vices Provider class will 
provide ait the services available from the BasetofoModel 
to the given BeanConcextServices object. 




This class populates JAFMsnus for generic collections. 




The DataIte:nActiontfanager class provides some uscfill 
static methods for dealing with actions cn Lei fDatal terns. 




This class Is an actionLtstener to be-used with 
Leiflleference "Load" menus. 






The DataltenKenuSet class is used by the • 
LeiflAFUtilities class to return essentially a Dataltem 
popup menu with annotation. 


.C? Udieu^ejwSstkGniQ! 


The Data I teawenuSet. Entry class encapsulates a 
Dataltem and it's menu, and also provides some 
convenience methods for adding additional menu items. 


DeraultWrapperAttribute 


The Oeraulcw copper Attribute class is a generic 
attribute that is the superclass of al! defaults in generated 
domain attributes. 


DisplavLahcl Attribute 


The DispiayLabelAtcribute diss is used to display 
one or more Attribute values in conjuction with string 
literals specified by users. 


DJspjaxUOifiiniiia ^ 


The DlspiayLabelOate. class is Used by the 
DisplayLabelAtiribu** to store a mapping cf 
Lei fData Items to DisplayLabelTempiates. 


OupIayLabglTemnUtc 


The DispiayLabelTsmplate class is used by the 
Dispi a y Labs lAt tribute to compute and store editing 

and renderino values fHr f»v» rv \ ^eifTiRtriltem that ha? the 

attribute. 


DomainMethcd 


Abstractly represents a" Domain Method. 


DoraainMethodDescriotor 


The OomainrtcthodDescripcoc class b used to describe 
a DomairuMemod. 




The DomainMethodDescciptor Factory class is a 
singleton class used to create or get 
QQMinaeth«UOcacriotors. 


Domain Wrapper 


This class adds methods ta Lei fDatal tern delegator (hot are 
useful In the domain wrappers. 


pynamjcAttrjbu<e$ 


The Dyr.atoicAtt r ibut ft a class is used for storing 
dynamic attributes. 
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FieldMetaData specifies sorting and subset criteria for an 
attribute. 


Fj=l4j^.taJ&atas. - 


The FieidHata'Oacas class represents a collection of 
FieldMetaData for a data item. 


larojWodelDoiAll^m 


TTip r n FnMm4« s f)» h a t r *m allow* view^ to wran 

LcifDataltems and add/rcmove/modify attributes that will 
only affect that view. 


InroModelSubseJ 


Typically when creating an InfoModel to oest within an 
existing InfoModel. which is done by VtewUtBeans, an 
InfoModelSubset is used 


I nvalidWrap pe r Att rjby tj 


The InvalidWrapperAttribute class 


LeifDntaltemComparator 


l (ic LXiiudLUi icrni^umpEniiur conrpar&s L>suu aia ICS ITlS Or 

Attribute Descriptor supplied by the user. 


LeifDataltemDeleeator 


Implements the methods in LeifDataltem in a wrapper so 

vnii don't have to, 


L^CDolfl.IttJOfiQXtsr 


The LeifDatafternSorter provides a default sorting tool for 
all LEIF LeifDataltem obiscts 


Lei tDa taft emUpdaU 


This classes is used with the LeifDataltemQbserver. 


Leiflnitialization 


Tbc Lctflnitialiration class handles some standard 
initialization for most XI5 Applications. 


LeiUAyUtiittieS 


The LeifJAFUtilLtiea class provides some useful static 
methods for LEIF-relatcd JavaBearts Activation Framework 




This class is an actionLister.er to be used with 
LeifReferencc "Load"* menus. 


LeifRequest 


TTip ? (»{ -P Domm «i t- class ic used to oackaoe all ?he 

necessary parameters for requesting information tor a 
LeifDataltem. 


JUeiJCLrBiisajrtiQD 


The *.evf?r»n3«ption class is used to construct a 
transaction. 


lacked jagi fPa (a I tern 


The LockedLeif Da tat tem class is used to enable locking 
on the data item. « 


MeUuxJReqtjest 


The Me "nociRe quest class is used to package all the 
necessary parameters for invoking a Doo\aiaMethod for a / 
LeilDataltem. 




Mutable subclass of Attribute Descriptor. 


Obser»erSuppori 


This class provides us end support for using the 
LeifDataltemObserver. 


RequestPooI. 


The Request Pool class is used to assist Object pooling. 


Rwonrccs . 


The Resource a class is automatically generated and must 
be public, but it is intended to be used only by Java's 
Internationalization support classes. 


SeleclgbleDatattem 


Creates a wrapper ai-ound a LeifDataltem for a 
SelectablelnfoModel. 


SelectablelnfoModel 


Manages selections for the selectable teif data items that are 
contained within this model. 


Translator 


A major design goal for XiS was to provide the ability to 
integrate existing data item classes without modifying them. 



WO 02/46916 



69/90 



PCT/US01/48418 



Tj-anslqiQrFUgUiry 


Provides a central location for maintaining Transition, 
extended Translators and locating Domain methods on data 
items. 


UntififinetfAttribute 


The Undefined** tribute class represents in undefined 
attributes. 






The visibllityMcrLbutd class is an Attribute that is 
ready to use for LeifDataitem visibility. 



Exception Summary 




The OacaltflmNotfour.dExcaption class is an exception that can be thrown 
when trying to look up a data item from an kj 


Invjj I idQbj e^chemaj;i«rcpiipti 


Signals that there was a problem with the creation or modification, of an 
ObjeciScherna. 


TrMslato«-C«entlon 


The Trans' latorEaception class 


UncomrtibleAli^SsFeptfon, 


Indicates that the requested attribute alias could not be calculated or converted. 


Undefined L^ifAttributeErcenHon 


Indicates -that the requested attribute is not applicable for the object. 


Undefined LelfMethod Exception 


The UndeflnedLeifMeihodException class indicates that the data hem does not 
define the method. 


UnremovableAUrlbuteExctDilon 


The UnremovablcAttributeExeeption class indicates an attempt to remove an 
Attribute that was defined by the raw data item (either by reflection or a 
Translator.) Only additional Attributes added to LeifDataltems can be removed. 
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com.xis.leif.ini 

Interface InfoModel 

All Superinterfaces: 

BeanContextCh.ildOwner, BeanContextChildOwnerDelegator . BeanContextProxv 

AH Known Implementing Classes: . • 

InfoMbdelSubset 



public interface InfoModel . 
extends ^ajjC^^hjldQwnecP^te^atoj 

The InfoModel interface is the interface that is used to convert raw data items into LeifDataltems. The InfoModel should 
hold each of these LeifDataltems created using weak references, so that the data items can be cleaned up when they are no 
longer being used. //PENDING(RJC): Any method marked with "PENDING" in the JavaDoc-will Ukely be removed 
before LE1F is released in final form. 

Since: 

LE1F4.0* 
Version: 

^Revision: i .20 S, JDate: 2001/08/17 00:54:54 $ 
Author: 

David AlmilU 



Method Summary 


void 


ac tiva .taQneOfNS ervica { Object s e rv i c e ) 

//PENDrNG(RK): This method will probably be removed from InfoModel! Notify the InfoModel 
that the given service is the preferred service of its type, and that this particular object should be returned 
if its class is requested, until removed or until another object of the same type is passed to a future call to* 
this method.' * 


void 


addlnfoModalListener (InfoModelListener listener! 


• Adds a listener to this InfoModel so that the listener will be informed of changes to the InfoModel. 


void 


addOneOfNS ervica (Object service 1 

//PENDfNG(RK): This method will probably be removed from InfoModel! Add an object as a 
service to be retrieved by a call to getServiceQ (via BeanContext APIs) on any class that this object 
implements or extends. 


void 


ciearSelection ( ) ■ 
Clears the selection. 


L*i fOataleem 

u 


dugpO 

Gives a list of all the LeifDataltems currently in the InfoModel. 




qet2scContext{) 

Gets an EZ Context that corresponds to this InfoModel so the developer can use the EZ APIs. 
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g a t L e i £D a ta X teai (long uid) 

This will attempt to lookup a LeifDatatiem from an id. 


LaUQinUw 


oa&ItcifDatal tern (Ob j ect rawOacalteraJ 

This will wrap a raw Java Object with a LeifDataltem wrapper so you can use it in leif as.a data 

item. 




crefcLe ifDa tat tern (Obi cct rawDotaltem. boolean createJ 

This will wrap a raw Java Object with a LeifDataltem wrapper so you can use it in leif as a data 
item. • . 


LelftiUf.sa 

n 


cratL*ifOatartBjas(Obieccn cawOatalteiasi 

This convenience method will wrap an array of raw java Objects, with LeifDataltem wrappers so : 
you can use them in leif as LeifDatallems. 




getFaxenilnZat^odelt) • 

Provides access to the parent InfoMcdel that this InfoMcdel delegates to. 




qetSelecfcedRawOatal turns 1 1 

Gets the list of all die currently selected items for this InfoModei 




Get the selected raw data item, if only one. 




gotViavHostn 

Gets the VicwHost that this fnfcModcl is associated with. 


void 


remove Inf oHodeXI«iateaer ( jnfQMoclBljuigtener listaner) 

Removes a listener from this InfoModeJ so that the listener will no longer be informed of changes 
to the InfoModei. 




rcmovoOneOfMSarvico (Object service) 

//PENDING(RK): Tnis method will probably be removed from Info Model I Remove an object that 
was a service to be retrieved by a call to getServiceQ (via BeanContext APIs) on any class that this 
object implements or extends. _ 



Methods inherited from interface com.xls.beans.beancontexL BennCnntextChtldOwnerDelefator 
laJUijU. I safiaafiCaQfc&&fcE&SeiU ccs 3 , raieaseBcanConcaxtResoucces 



Methods inherited from interface com. x is. beans, bean coo textB ennContgxtChildQwnei 
qe tPv nedaeanCor.tex t Child 



Methods inherited from interface java>beans.beaneontcxt.Qep.rrQlDleytProxy 



Method Detail 



getLeifDataliem 

public LqiCDacaltem getLeifDatalfcaaUong uid J 

throws DataltenMotroundExceotign 

This will attempt to lookup a LeifDataltem from an id. If the UtD is invalid or there isn't a LeifDataltem that 

already exists with that given UID, an exception will be thrown. 

Parameters: 

u id - the unique id for the raw data item. 
Returns: 
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the UifDataltem with the given UID 



getLcifDataltem 

public kejL£Qa£a_lce3i gatieifDataltem(pbiaEi rawDataltem) 

This will wrap a raw java Object with a'LeifDataltem wrapper so you can use it in lei f as a data item. 
Parameters: 

rawDacaltem * the raw data that will be wrapped. (Note: this should not already be a Lei/Dataltem) 
Returns: 

the wrapped data item. 



getLeifDataltem 

public J.aiiEa.t.ftl£5S getI^ifDataItam(Qiij£££ rawDa taltem, 

boolean creace) 

This will wrap a raw Java Object with a LeifDataltcra wrapper so you can use it in leif as a data kern. 
Parameters: 

rawDataleaa - the raw data that will be wrapped. (Note: this should not already be a LeifDataliemJ 
create - if false and the LeitDataltem is net already in the model, dont create one and return null 
. Returns: 

the wrapped data item, or null if "create* is false and not found 



getLeifDatalterns " 

public Let fOa'ca Item ?) getLeifDatal terns <Q&I£££U rawQataltejns ) 

This convenience method will wrap an array of raw Java Objects with LsifDataltem wrappers so you can use them 
in leif as LeifDatal terns. Note that you can get an array of raw data items often from methods like getMembersO, 
so this is a useful method to have. 
Parameters: 

rawOatal tenia - the raw data objects that will be wrapped. (Note? the ofy'ects should not already be 
leifOaioiiems) 
Returns: 

the corresponding wrapped data icem array. 



^getEzContext 

public EzContaxt gotlzContaxtO 

Gets an EZ Context that corresponds to this InfoModel so the developer can use the EZ APts. 
Returns: 

the cz context for this info model 



getSmgleSelectedltem 

public G&iscj; SBtSingleS-electedltean 
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Get the selected- raw date item, if only one. Else return null. 
Returns: 

the. selected item if there is only one. 



getParentlnfoModel ' 

public InfoHc-Jfil gatPac&ntlnfoHodal () 

Provides access to the parent InfoModel that this InfoModel delegates to. If there is no parent model then this will 

return null. 

Returns: 

the parent InfoModel 



clearS election 

public void clBax3*l«ctionO 
Clears the selection. 



getSelectedRawD ataltems 

public Ob ject [] g«tS«iect-edRaw0ataItea5 U 

Gets the list of all the currently selected items far this InfoModel 
Returns; 

all of the selected data items (as raw data Items) 



acjtivateOneO fNService 

** * • ' 

public void activateOneOfHacrvico { Object service) 

tfPENDING(RK); This method will probably be removed from InfoModel! Notify the InfoModel that the given 
service is the preferred service of its type, and that this particular object should be returned If its class is requested, 
until removed or until another object of the same type is passed to a future call to this method. 
Parameters: 

service - the object to become the preferred service 



addOneOfNScrvice 

public void addOneO^KSaxvica { Object service) 

//PENDING(RK); This method will probably be removed from InfoModel! Add an object-as a service to be 
retrieved by a call to getServiceO (via BeanContext APIs) on any class that this object implement or extends. 
. Parameters: 

service - the object to be returned when requested 
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removeOneOfTVService 

public void removeCreOfW5arvica (gbjgct service) 

//PENDfNO(RJC): This method will probably be removed from InfoModel! Remove an object that was a service to 
be retrieved by a call to getServiceQ (via BeanCcntext APIs) on any clasj that this object implements or extends. 
Parameters: 

service - the object to be removed from service 



getView.Host 

pub Lie VJjawJisS* getViawHostl) . .* 

• Gets the ViewHost that this InfoModel is associated with. If this InfoModel is not associated with a Vicwpost then 
this will return null. - 
Returns: . 

the view hostthat is maintaining this InfoModel. 



addlnfoModelListener 

public void addZnf oMode LLis turner ( InfoModel Listener listener) 

Adds a listener lo this InfoModel so that the listener will be informed of changes to the InfoModel. 
Parameters: 

listener - the listener to add 



remcrvel nfoModelLis ten er 

i 

public void ^eaovBlnfoModal-Lia taner I In f oMode LLi s tensr listener! 

Removes a listener from this InfoModel so that the listener will no longer be informed of changes to the 

InfoModel. 

Parameters: 

listener - the listener. to remove 



dump. 

public LBUPftMUftHM duapU 

Gives a list of all the LeifDataltems currently in the InfoModel It is highly recommended to use this method only' 
if you absolutely have no other way of accomplishing the task you need to do. Please keep in mind that if you hold 
onto the LeifDataltems contained in the array returned or if you hold onto the array itself, the items will not be 
removed from InfoModel until you release them. If you wish to hold onto them, you should wrap them in 
We&kReference objects. 

Note: When you use the dumpQ method in combination with the addlnfoModelListener so that you can keep track 
of the same set ofLeJfDataltems as the InfoModel. ycu can synchronize on the InfoModel to get the damp and 
then add a listener to receive events of future changes. 
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Example; 

synchronized (inCoModel) I 

Lei f Data Item ( } dataltems ■ infoModel .dump O ; 
in foModei.addlnfoModel Listener (this) ; 
for tint i=0; i < data Items . iength; i++) { 
process Item (datal terns (i] ] ; 

. I- 



Returns: 

the lis* of LeifDataltems currently in the InfoModel. 
See Also: 

WeakRefarence 
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Package com.xis.leif.eveiit 

This package contains classes for handling events in XIS. 



See: 

Description 



Interface Summary 


InfoModelLisiener 


The Enf oModelListenex is used to monitor changes to an InfoModel. 


LeifDataltemListen er 


This class is used for listening to LeifDataltems for various events. 



Class Summary 


Attrlb u teC ban aedE vent 


An "AttributeChanPBd" event aet<s delivered whenever a rlata if°m 

changes an attribute value. 


ContainerAddedEvent 


A "ContainerAdded" event gets delivered whenever a data item is 
contained as a member in a new object. 


ContainerRemovedEvent 


A "ContainerRemoved" event gets delivered whenever a data item has 
been removed as a member from a containing object. 


DataltemReplacedEvent 


The DataltemReplacedEvent class is used to indicate member changes 
of a containing data item. 


InfoModelEvent 


The InfoModelEvent gets delivered whenever a LeifDataltern is created 
by the InfoModel; or when a LeifDataltern has been "lost" by the 
InfoModel. 


InfoModelEventSupporf 


The rnfoModeiEventSupport support class provides basic support for 
managing listeners on an InfoModel. 


LeifDataltemAdapter 


The LeifDataltemAdapter class provides support for setting up a 
LeifDatalternListener on a data item. 


LeifEventSupport 


This is a utility class for XIS developers to use when they want to fire 
event changes. 


MemberAddedEvent 


The MemberAddedEvent class indicates that members were added to 
mis data item. 


MemberEveat 


The MemberEvent class is used to indicate members changes of a 
containing data item. 


MemberRemovedEvent 


The MemberRemovedEvent class indicates that the members are being 
removed from the containing data item. 


ReferenceAddedEvent 


The ReferenceAddedEvent class indicates mat LeifReferences were 
added to the LeifDataltern. 


ReferenceEvent 


The ReferenceEvent class indicates changes to the LeifReferences of 
the data item. 
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ReferenceReraovedEvent 


The ReferenceRemovedEvent class indicates that LeifReferences were 
removed from the LeifDataltem. 


ReferrerAddedEvent 


The ReferrerAddedEvent class indicates that a Referrer was added to 
the data item. 


ReferrerRemovedEvent 


The ReferrerRemovedEvent class indicates that a Referrer was 
removed from the data item. 



Package com.xis.leif.event Description 

This package contains classes for handling events in XTS. 
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1 : addRawDataltem 




5 ; interrogate &et Attributes, etc) 



Figure 36C 
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Pfitfl BomsgiQSl sid 



InfoBean 



1 : Data updated 



I ftnnataitem 



2 : fSroperty change event 




3 : attributeChanged 
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4 : attrifruteChangsd 



5 : seJtAttributeO 
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Figure 36D 
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Figure 37A 

TestHarnessjava 



r XIS Tutorial standalone sequence example 5 XI S interfacing. */ 

import javax.swing JFrame; 
import java.awt event WindowAdapten 
import java.awteventWindowEvent; 
/*{*/ 

import java.awtGridLayout; 

import java.awtToolkit; 

import java.awtDimension; 

import java.awtevent.ComponentAdapten 

import java.awteventComponentEvent; 

import javax.swing JSplitPane; 

import javax.swing. JComponent; 

/•}*/ 

import jclass.chart JCChart; 

import com.xis.leif.im.BaselnfoModel; 

import comjcis.pIotPlotlnfoBean; 

import com.xis.plot.chartviews.LeifChartView; 

/*{7 • 
import com.xis.table.TablelnfoBean; 
import comjds.tree.TreelnfoBean; 
/*}*/ 

public class TestHamess { 
public static void main(StringQ args) { 

//the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaseinfoModeLsetStartingPluglnManager(fa!se); 

/*{7 

HelioWorld hellol = new Hel!oWorid("First HelloWorld object"); 
HelloWorid hello2 = new HelloWorld("Second HelloWorld object."); 
HelioWorld hello3 = new HelloWorld("Third HelloWorld object."); 
HelloWorid hello4 = new HelloWorid("Fourth HelioWorld object"); 
HelioWorld belloS = new HelloWoridCFifth HelloWorld object"); 
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Figure 37B 

Continuation of TestHarness.java 

ObjectO helloArray = new ObjectQ { hellol , helk>2, hel!o3, heHo4, 
helloS}; 

// create table and plot infobeans to display HelloWorld objects 
TabielnfoBean table = newTabIelnfoBean(); 

PloilnfoBean plot = new PlotlnfoBean(); 
piotsetChartType(JCChartBAR); 

//the alternatives are SCATTER_PLOT, PLOT, AREA, PIE, CANDLE, 
// and STACKING_BAR, though not all will make sense in this example 

// We can set the attribute for initial display on the plot; 
// see step 3 for further comments. 
plot.setYAxisAttribute( 

,, com.xis.domains.movement.MovementDomain.speed ,, ); 
piotsetDynamicAdjustment(true); // so axes track value magnitude 
plotsetBarChartAdjusting(tnje); // needed in some cases for bar chart 

/*{7 . 

// a top-level frame as before to hold both plot and table side-by-side 
JFrame tablePlotFrame = new JFrameCHelloWorld(s) Table/Plot"); 
// use a repaired JSplitPane (see below) to manage the two beans 
SaneJSpIitPane splitpane = new SaneJSplitPane(tabIe,plot, 
new Dimension(table.getPreferredSize().width + 
plotgetPreferredSizeO.width, 
Math.minttable.getPreferredSizeO.height, 
pIotgetPreferredSize().width)), 

0.50); 

tablePlotFrame.getContentPane().add(spiitpane); 

tablePlotFrame.pack(); 

tablePlotFrame.setVisible(true); 

// a tree infobean to display our HelloWorld objects 
TreelnfoBean tree = newTreelnfoBeanfHelloWorid(s) Tree"); 
tree.addRawDataltems(helloArray); 

// a top-level frame to hold our tree infobean 

JFrame treeFrame = new JFrameCHelloWorldfs) Tree"); 
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Figure 37C 

Continuation of TestHaraess.java 

// avoid placing the windows on top of one another if we can 
int cutoffHeight = 424; 

if (TooIkit.getDefaultToo!kit().getScreenSize().getHeight() > 
cutoffHeight +.200) { 

treeFrame.setLocation(348 > cutoffHeight+7); 

} 

V 

// add a listener for window closing 
treeFrame.addWindowListener( 
new WindowAdapterQ { 

public void windowdosing(WindowEvent e) { 
System.exit(O); 

} 

} 

); 

// stick the tree infobean in the frame and display it 

treeFrame.getContentPane().add(tree); 

treeFrame.pack(); 

treeFrame.setVisible(true); 

}//main 



r 

* This class overrides the default JSplitPane to provide a reasonable 

* resize behavior maintain the left and right panels in the same 

* proportions. 
*/ 

public static final class SaneJSplitPane extends JSplitPane { 

private int lastWidth; 
private double lastDividerProp; 

public SaneJSplitPane(JComponent leftComponent, 
JComponent rightComponent, 
. Dimension dims, double startProportion) { 
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Figure 37D 

Continuation of TestHamess.java 

super(JSplitPane.HORIZONTAL_SPLIT, ■ 

leftComponent, rightComponent); 
setSize(dims); 

// Since the JSplitPane doesn't set the lastDividerLocation 
// variable, nor does it provide any other easier way to maintain 
// the split proportion on resize, we must track the divider 
// location ourself. 
lastWidth = dims.width; 
lastDividerProp = startProportion; 
setDividerLocation(startProportion); 

// this listens for resize events on the splitpane and makes sure 
// we keep same split proportions 
addComponentListener(new ComponentAdapter() { 

public void componentResized(ComponentEvent event) { 
setDividerLocation(lastDividerProp); 
lastWidth = (int)eventgetComponent(). 
getSize().getWidth(); 

}}): 

// only way to know if divider moved by user is to listen for 
// resize events on the components; this isn't foolproof (since 
// resizes can come from other sources) but it works well enough 
IeftComponentaddComponentListener(new ComponentAdapter{) { 
public void componentResized(ComponentEvent ev^nt) { 
// we add in getDividerSize() / 4 to compensate for a 
// bug in JSplitPane which doesn't take account of the 
// divider width in location-proportion conversions 
lastDividerProp = (doub!e)(getDividerLocation() + 
(getDividerSize() / 4)) / lastWidth; 

}}); 

} 

} 



} 
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Figure 38A 



EBB HelloWorld(s)Tree 
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Figure 38B 
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Figure 38C 
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com.xis.leifJin 

Interface AttributeAIias 



public interface AttributeAIias 

The AttributeAIias indicates an alias from l.-n .Attributes to a single Attribute, together with a 
precision level; the higher the precision, the better the alias. The alias allows a caller to query for one 
of the Lji "from" attributes and get the value stored by the data item under the "to" attribute, possibly 
mediated by some conversion, such as a units transformation. 

If the converted or calcuated value cannot be determined, then the At tributefcget Value ( ) method 
should throw an QnconvertibleAliasExceptioru This Exception is a subclass of the 
DndefinedlieifAttributeException which is typically thrown by normal Attributes in this case, 
and it can provide a descriptive message indicating the source of the incompatibility. 

'The utility of attribute aliases may be seen by considering the following example: . 

The user has performed a query from an external data source and retrieved a set of Airfields, indexed 
by an ICAO identifier. The user now wants to get the list of Aircraft at one of the airfields. There is a 
local aircraft database with a foreign key field for Airfields, but that key is a WAC identifier, not 
ICAO. 

Assumption: The application was NOT written ahead of time to know about these two databases or 
their ID types. Instead, what you have is an XIS "LeifDat altera" for the Airfield, and you have an . 
XtS InfoBean for the Aircraft query form. ■ 

What you want to do is to copy (or "drop") the Airfield data item into the "WAC" field in the query, 
form. In doing this, the Form will ask the data item for its "WAC" attribute" (because this is all it 
knows about). It uses the "getWAC ( ) " method from some domain (say, the Airf ieldDomain). 

The way this could work is that there would have to be an AttributeAIias defined to convert ICAO 
to WAC - or, more specifically, AviationDomain. TCAOto Airf ieldDomain.WAC The 
AttributeAIias returns an Attribute object that knows how to transform ICAOs to WACs (e.g., 
by accessing a conversion table). The Attribute, in turn, has a getvalue { ) method to execute that 
. transformation and return the WAC. 

This process would be entirely transparent to the user, or even the caller, who would just see a result 
returned from the getWAC { ) method. In cases where the conversion was not possible, the 
OnconvertibieAiiasException would.be thrown, possibly providing informative information to 
the caller or user. 

Finally, note that due to the way the mechanism is set up (using resources and a PluqoabXeService) , 
this AttributeAIias can be installed as a separate module without requiring any re-coding or re- 
compilation of the existing application. 
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Method Summary 




getAliasedFrom ( ) 


U 


.This indicates which AttributeDescriptors (which in turns means which 
Attributes) are required for the alias. • 


At; p p.l.l?Mt ^ p^^ci;ip toR 


cretAliasedToO 

This indicates the AttributeDescriptor that this AttributeAlias is for. 




ere tAt tribute { ) 

. Get the Attribute object that is the alias Attribute. 


iat 


getPrecisionPriority ( ) 

This indicates the precision of the AttributeAlias. 



Method Detail 



getPrecisionPriority 

public int getPrecisionPriority () 

This indicates the precision of the AttributeAlias. The higher the number the better the alias. 
This number is used to determine which AttributeAlias to use when there are more than one 
alias for a given Attribute. 
Returns: 

the precision of the alias. 



getAliasedFrom 

public AttributeDescrip tor £ 1 getAliasedFrom ( } 

This indicates which AttributeDescriptors (which in turns means which Attributes) are required 

for the alias. . 

Returns: 

the list of descriptors required for this alias. 



getAliasedTo 

public At t r ibut e Pes crip tor getAliasedTo ( ) 

This indicates the AttributeDescriptor thai this AttributeAlias is for. 
Returns: 

the descriptor that this alias is for. 



Ho 3^6 
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getAttribute 

public Attribute getAttribute ( ) 

Get the Attribute object that is the alias Attribute. This attribute is responsible- for performing 
the translation from the aliased from Attributes. The AttributeDescriptor of the Attribute 
MUST be the same AttributeDescriptor returned by getAliasedTo. 
Returns: 

the attribute that will do the translation. 



FTa. 31C 
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